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Introduction to A/UX Release Notes, Version 1 .0 

These release notes contain late-breaking information about release 1.0 of the 
A/UX™ software for the Apple® Macintosh® II computer. This package contains two 
kinds of materials: 

□ Specific information that was not available in time to be incorporated into the 
printed manuals. Insert the pages that contain this information in the "Notes" 
section at the back of A/UX Local System Administration. Some of this material 
represents an expansion or update to a specific manual. In these cases, you may 
want to mark the table of contents for the affected manual with a reference to these 
release notes. 

□ Replacement command reference pages. Insert these pages alphabetically by 
section into the appropriate A/UX reference manuals (A/UX Command 
Reference, A/UX Programmer's Reference, and A/UX System Administrator's 
Reference). 

You should read these release notes before installing and using your A/UX system, so 
that you can avoid potential problems caused by using out-of-date documentation. 

Additional update information appears in the software itself, in the standard text file 
/README. You can read this file in either of two ways: 

□ Page through the text by entering the command 

more /README 

To see more information, press the space bar at the — More — prompt. When 
you reach the end of the text file, you are returned to the shell. To quit before the 
end of the file, press the Q key. 

□ Use your favorite A/UX text editor to read the text. 



These release notes are divided into eight sections: 

Section 1, "Programming Notes," contains a collection of implementation notes 
directed primarily at programmers. 

Section 2, "System Administration," supplements information in A/UX Local 
System Administration. 

Section 3, "Network Administration," describes the procedures for configuring your 
A/UX system for communication over a network. It supplements information in 
AAJX Network System Administration, which is available through the Apple 
Programmer's and Developer's Association (APDA). 

Section 4, "Adding Extra Hard Disk SCs," explains how to attach an additional Apple 
Hard Disk SC to your system for use with either your Macintosh Operating System or 
your A/UX operating system. This section supplements information in your A/UX 
Installation Guide. 

Section 5, "A/UX Toolbox," supplements information in A/UX Toolbox: Macintosh 
ROM Interface. 

Section 6, "A/UX Kernel Messages," describes the error messages generated by the 
A/UX kernel. 

Section 7, "Terminal Display Problems," provides information for configuring your 
display terminal after using a remote or non-A/UX terminal type. 

Section 8, "Serial Port Difficulties," provides information regarding the Macintosh II 
device priorities of the SCC (serial) port interface and the IWM (floppy disk drive) 
interface. 

Section 9, "RS-232 Cables," describes RS-232 cables used to connect DCE and DTE 
devices to the serial ports on a Macintosh II. 

Section 10, "Manual Pages," contains a list of minor changes to printed manual 
pages and a set of replacement pages for printed manual pages. 
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Section 1 



Programming Notes 



This section contains a series of technical notes and warnings. It describes the origin 
of A/UX software, the differences between A/UX and other operating systems based 
on UNIX, and some details about this implementation. This section also describes the 
software-distribution disk and the handling of user address space. 



What the A/UX system runs 

The A/UX system is based on AT&T's UNIX System V Release 2 (V.2). It is a virtual- 
memory, time-sharing system with several additions, including 

□ TCP/IP Ethernet communication software 

□ 4.2 Berkeley Software Distribution (BSD) signals 

□ some 4.2 BSD system calls 

□ Sun Microsystems' NFS 

A/UX resembles a V.2 system more closely than it resembles a 4.2 system. Many V.2 
commands have different options from the corresponding 4.2 commands-, please 
check your A/UX reference manuals. Also, many functions have different names on 
the two systems. (For example, the 4.2 BSD functions index and rindex are called 
strchr and strrchr, respectively, in V.2.) 
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Signals 

A/UX supports two different versions of signals: the standard V.2 signals and the 4.2 
reliable signals. To use 4.2 signals in a program, issue a call to the set42sig routine 
before issuing any calls to the signal function. 

Do not attempt to mix the signal systems. Although you can mix 4.2 and V.2 signals 
using the setcompat and getcompat routines, this strategy is not recommended for 
a portable application. The signal-handler setting is not inherited across an exec 
call, although job control and process groups are available to shell programs. See the 
manual pages for signal(3), set42sig(2), setcompat (2), and getcompat® for 
more details. 



Streams on the console 

The console device (the video monitor) runs with a streams line discipline. This line 
discipline acts like the standard system V.2 line discipline, except that on the first 
open, you must push the line discipline module. If you do not, you will have only a raw 
terminal that provides no handling of line commands such as erase and kill. The 
standard UNIX programs, such as getty and login, push the line discipline module. 
However, if you disable all logins on a device and want to run your own application 
that expects standard line discipline handling, your application must push the line 
discipline module: 

fd = open ("/dev/console", 0_RDWR) ; 
line__push(fd) ; 

See the manual pages for streams(7), termio(7), console(7), mouse(7), 
linej?ush(3), and stty(l). 



VNODES and directories 

A/UX runs a VNODE kernel. As a result, it is possible that a directory may not be a 
standard V.2 directory (in fact, it might not even be a UNIX directory). Apple 
recommends that any application that needs to read directories use the standard 
Berkeley directory access routines (supplied in the C library). Any program that needs 
to create a directory must use the mkdir system call. Do not use mknod to create a 
directory. See the manual pages for directory(3) and mkdir (2) for more 
information. 
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rsh and remsh 

The standard V.2 system provides a command called rsh, a restricted version of the 
standard Bourne shell. The 4.2 networking command rsh has been renamed as 
remsh, for remote shell. See the manual pages for sh(l) and remsh(l) for more 
details. 



Groups 

A/UX runs 4.2-compatible groups by default. This means that any given user can be in 
more than one group at the same time. It also means that when files are created, the 
group ID of the file is the same as the group ID of the directory in which it is created, 
not the accounting group ID of the user. You can change this behavior with the 
setcompat and getcompat routines. See the manual sections for groups(l), 
groups(8), setcompat(2), and getcompat (2). 



termcap and terminf o 

A/UX provides two terminal capabilities data bases. The V.2 data base is a set of 
compiled capabilities files found under /usr/lib/terminfo. The other data base, 
/etc/termcap, is a text file that can be edited and that is used by BSD utilities ported 
to A/UX. In some future release of A/UX, these utilities will probably be converted to 
use terminfo, and the file /etc/termcap will be dropped. 

When modifying terminal capabilities, keep in mind that A/UX utilities do not use 
both data bases. In particular, tset and more read /etc/termcap; vi uses 
/etc /terminfo. 



Printing 

A/UX uses the System V.2 suite of line printer programs (lp, access, lpadmin, 
lpstat, and so on). The Berkeley printing commands (lpr, lpq, and lprm) have 
been implemented as shell scripts. These implementations may not precisely 
duplicate the functionality of the original Berkeley utilities. 
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Kernel parameters 

On a system with more than 2 megabytes (MB) of memory, you might be able to 
improve system performance by altering some kernel parameters. See the discussion 
of resetting kernel parameters in the "System Administration" section of these release 
notes. 



Access to the video monitor and mouse 

See the console(7) and mouse(7) manual pages for information about access to the 
video monitor and mouse. 



Big C compiler 

The directory /usr/lib/big contains versions of the C compiler, assembler, and 
link editor for compiling large programs. These tools are the same as their standard 
counterparts, except that their symbol tables are very large. Use these large versions of 
the C tools if you get a symbol table overflow error while compiling your program. 

To invoke the big C compiler, add this flag to your cc command line: 

cc -B /usr/lib/big/ -o filename filename. c 

See the cc(l) manual page in AAJX Command Reference for more information. Use 
of the big C compiler is not recommended on A/UX systems with 2 MB of memory. 



Public domain utilities 

This distribution includes source code for several useful public domain programs: 
emacs (a popular text editor), kermit (a file transfer protocol), compress (a set of 
file compression utilities that use a faster and better algorithm than pack and 
compact), and pcnf sd (a utility for using the Network File System with an IBM PC). 
This source code is located in the directory /usr/src. 



Warning 

These public domain utilities are provided as a courtesy to A/UX users, and are 
not supported by Apple Computer, Inc. 

These programs are not compiled. Manual pages, if they exist, are unformatted and 
are located with the source code. An exception is kermit, which exists in binary form 
in /usr/bin. To see the manual page for kermit, enter the command man kermit. 
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If you need more space on your disk, you can delete or compress some or all of this 
source code. 



Layout of the Apple Hard Disk 80SC 

The Apple Hard Disk 80SC, preloaded with A/UX, is divided into nine partitions. The 
disk contains both A/UX and Macintosh Operating System (OS) partitions. The size of 
a block is 512 bytes. 

Table 1-1 shows the block definitions. 

Table 1-1 

Block definitions 

Start End Blocks Description 

Hard disk block zero 

Apple partition map (63 entries) 

Macintosh OS HD 80SC disk driver 

Reserved for HD 80SC disk driver expansion 

A/UX eschatology (autorecovery) file system 1 

A/UX root (/) and user (/usr) file system 

A/UX swap space 

Macintosh OS HFS (A/UX booter) 

A/UX eschatology (autorecovery) file system 2 

Free space and padding 

If you want to remove some disk contents to make more room for user data, see the 
"System Administration" section of these release notes. 

If you want to add an additional hard disk to hold user data, see the section "Adding 
Extra Hard Disk SCs" in these release notes. 



Address space 

Figure 1-1 illustrates the organization of user process address space. Note that the total 
available address space is 512 MB. 

Figure 1-2 shows the kernel address map, which you need if you are writing an A/UX 
device driver. 
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Figure 1-1 

Organization of user address space 
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Kernel address map 
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Device drivers 

At first release, the A/UX kernel includes these device drivers: 

□ Apple Desktop Bus™ (ADB). This supports the keyboard and mouse. Both a 
standard ASCII keyboard interface and a key-up/key-down interface are available. 
Mouse events are available. 

□ Video driver and console emulator. The console terminal emulator supports a 
subset of VT100 terminal features. 

□ Floppy driver. Both single-sided (400K) and double-sided (800K) disks are 
supported, although only 800K drives are normally available on the Macintosh II 
hardware. Both 400K and 800K disks can be read, written, ejected, and formatted. 

□ SCSI manager and SCSI disk driver. These support the Apple Hard Disk 80SC drive. 

□ Serial Communications Controller (SCC) driver. 

□ NV ("Parameter") RAM and time-of-day clock driver. 

□ Ethernet driver, with full TCP/IP and NFS support. 

□ The A/UX Toolbox driver (see the section "A/UX Toolbox" in these release notes). 
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Section 2 



System Administration 



This section supplements AAJX Local System Administration. It covers five system 
administration issues: 

□ reclaiming disk space 

D booting into multiuser mode 

□ changing kernel parameters 

□ using autoconfiguration 

□ using autorecovery 

For information on network administration issues, see the section "Network 
Administration" in these release notes. 



Reclaiming disk space 

The A/UX release includes all the files needed to run A/UX locally, plus the source 
files for an array of public domain software. Single-disk systems do not have much 
room available for user data. 

You can make more room on your disk by removing software that you do not use. For 
example, you can delete or compress the public domain software or delete the on-line 
manual pages. Always back up files before deleting them from the disk. 

If you have more than one Macintosh II on a network, you can store shared resources 
such as manual pages on one Macintosh II, and remove those files from other 
computers on the same network. Both the server machine and the client machines , 
must be configured for NFS. 
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To set up one Macintosh II as a manual-pages server, for example, follow these steps: 

1 . On the server, make the /usr/catman directory exportable by using this process: 

□ Become the superuser by entering the command 
su 

password 

□ Edit the file /etc/exports, adding entries for / and /usr/catman. 

2. Set up the client computers to mount the /usr/catman directory remotely by 
using this process: 

□ Change to the /usr directory with the command 
cd /usr 

□ Become the superuser by entering the command 
su 

password 

□ Remove the man page source files by entering the commands 
rm -r catman 

mkdir catman 

□ Edit the file /etc/f stab to add this line: 

seruer_name: /usr/catman /usr/catman nfs soft,ro,bg 

□ Mount /usr/catman: 
mount /usr/catman 



Booting into multiuser mode 

As shipped, A/UX comes up in single-user mode. You must respond to a series of 
prompts, and then explicitly enter multiuser mode. This sequence is useful when you 
are first working with A/UX, looking around the system, and setting things up. (See 
your A/UX Installation Guide for more information.) 

After you have set up your system, you might wish to bypass single-user mode and the 
prompt for the file system check. 

To cause A/UX to come up automatically into multiuser mode, edit the file 
/etc/inittab. Change the line 

is : s : initdef ault 

to 

is : 2 : initdef ault 

To check the file systems automatically after a 5-second wait, without prompting, edit 
the files /etc/bcheckrc and /etc/sysinitrc. In both files, change the line 

reply=" s /etc/query" " 

to 

reply=" N /etc/query -t 5 s " 
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When you next boot the system, it should come up in multiuser mode, displaying this 
prompt: 

Apple Computer, Inc. A/UX 

login: 



Changing kernel parameters 

The A/UX software as shipped from the factory is configured for a system with 2 MB of 
memory. If your system contains more memory, you might be able to improve 
performance by changing some kernel parameters. Do not change any parameters on 
a system with 2 MB of memory. 

On a system with 4 MB or 5 MB, bring A/UX up into single-user mode, become the 
superuser, and enter the following commands (enter CONTROL-d by holding down the 
CONTROL key while pressing the d key): 

kconfig -n /unix 
NBUF=1000 
NINODE=200 
NFILE=200 

CONTROL-d 

sync 
sync 
sync 
reboot 

On a system with 8 MB, bring A/UX up into single-user mode, become the superuser, 
and enter the following commands: 

kconfig -n /unix 
NBUF=250 
NINODE=600 
NFILE=400 
CONTROL-d 

sync 
sync 
sync 
reboot 
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Autoconfiguration 

Autoconfiguration is a utility that runs automatically at boot time and checks the 
consistency between the hardware that is attached to your Macintosh II and the 
information in the kernel about attached devices. Autoconfiguration allows you to 
change your hardware configuration without resetting DIP switches or manually 
rebuilding the kernel. Autoconfiguration shields you from detailed knowledge of the 
interface between the hardware and the kernel, and protects against operating-system 
problems caused by mismatched hardware and software. 



How autoconfiguration works 

The A/UX kernel contains information about the devices installed in each slot. 
Whenever A/UX is booted, autoconfiguration checks this information against the 
cards installed in the slots. If the kernel contains drivers for hardware that is absent, or 
if known hardware is attached through a different slot than the kernel expects, the 
autoconfiguration program makes the appropriate changes to the kernel and then 
reboots the system. 



Adding new devices 

Autoconfiguration does not automatically add to the kernel any information about new 
devices. Autoconfiguration can work only with the device information already in the 
A/UX kernel. The system will not attempt to use a device until the kernel is configured 
for that device. 

When you add a new device, you must run the installation scripts provided with that 
device. These scripts use autoconfiguration to add the appropriate information to the 
kernel. You cannot use the device until after you reboot the system, at which time 
autoconfiguration checks that the hardware setup matches the kernel's information. 

If autoconfiguration detects a device for which the kernel has no driver, it prints a 
warning message. For example, when autoconfiguration locates the video card, it 
prints this message: 

Warning cannot find drivers for device ID 5 Version 7 
You can safely ignore this warning. 
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Where autoconfiguration is documented 

Autoconfiguration is described on the autoconf ig(lM) manual page in A/UX 
System Administrator's Reference. 



Autorecovery 

Autorecovery is a set of programs designed to ensure that an A/UX system can be 
brought to multiuser mode, and that it will then be able to operate as part of a network. 
Before the system is booted, autorecovery identifies and compensates for bad disk 
blocks, file-system inconsistencies, and missing or damaged files. Autorecovery is 
designed to protect you from sudden, catastrophic loss of data and to minimize the 
need for a technical expert to diagnose and repair system problems. 

Autorecovery does have limitations: it is concerned only with critical system files, and 
it does not restore damaged or missing user files. You must keep backup copies of your 
own files in case you need to restore them. 

Although most of autorecovery's operation is automatic, you must perform some 
administration tasks to keep autorecovery running smoothly. This section describes 
the administration tasks. 



Overview 

The terms autorecovery and eschatology are used to refer to the same A/UX feature. 
Autorecovery refers to the procedure that checks and repairs the A/UX file systems 
and to the special disk file systems used by this procedure. Eschatology is used in 
filenames and command names and in the arguments to commands. 

Two areas on the A/UX disk are reserved for autorecovery. Each area is a distinct 
A/UX file system that contains copies of key system files and other information about 
A/UX. If a key system file is damaged or destroyed, autorecovery copies the file from 
one of these systems to the A/UX root file system. 

Autorecovery uses a list of key system files known as the configuration master list, or 
CML. The CML appears in the A/UX root file system in the file 

/etc/eschatology/init2f iles. A copy of this file appears in each autorecovery 
file system. 

At boot time, autorecovery verifies the physical condition of the disk and then checks 
each file in the CML. Autorecovery uses rules stored in the CML to check file attributes, 
such as size, ownership, permissions, type, modification time, version, and 
checksum. If any attributes do not match, autorecovery corrects the file attributes, if 
possible. If autorecovery cannot make these corrections, it replaces the file. 
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Because autorecovery depends upon the CML to perform its duties, you must keep the 
CML up to date. When you add or change key system files, you must add new entries to 
the CML and update the files in the autorecovery file systems, using the autorecovery 
utilities eu and escher (discussed later). Autorecovery depends upon a conscientious 
system administrator to keep the CML and autorecovery file systems updated. 



Using autorecovery 

Autorecovery is run from the standalone shell (sash) when the system is booted. (See 
A/UX Local System Administration and the manual page for sash(8) in A/UX System 
Administrator's Reference for information on sash.) You can either run 
autorecovery manually each time you boot or set it up to be run automatically. 

To run autorecovery manually from sash, enter the command 
esch -v -b 

For a detailed explanation of the esch command and its options, see esch(8) in 
A/UX System Administrator's Reference. 

To set up the system to run autorecovery each time you boot, follow these steps: 

1 . Select the Cancel option from the sash window. 

2 . Select the Booting option from the Preferences menu. 

3 . Enter this command in the autorecovery box: 

esch -v -b 

4 . Click the OK button. 

To suppress the automatic running of autorecovery, follow the same steps, but replace 
the esch command in the autorecovery box with 

echo no autorecovery 



How autorecovery works 

Autorecovery proceeds through several phases. First, autorecovery examines the 
system information in its own file systems to verify that a system failure did not 
interrupt the previous invocation of autorecovery. If the autorecovery file systems are 
suspect, autorecovery cannot use them to restore damaged or missing files in the 
A/UX root file system. If autorecovery detects that an autorecovery file system was 
being updated when the system failed, it does not use that file system. If both 
autorecovery file systems are suspect, autorecovery does not continue. 
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After checking its own file systems, autorecovery checks each A/UX file system 
individually, verifying that all blocks are readable. It marks bad blocks so they will not 
be used. 

Autorecovery then checks the A/UX root file system and each autorecovery file system 
for consistency, by using a version of f sck. Autorecovery attempts to correct any 
errors it finds. If a file system is not repairable, autorecovery remakes it as a last resort. 
When autorecovery remakes a file system, all data in the file system are lost and must 
be restored from backups. 

After all file systems have been checked, autorecovery verifies the A/UX key system 
files listed in the CML, checking the attributes of each file against the rules specified in 
the CML. If autorecovery finds inconsistencies, it corrects the file, if possible, or 
replaces it with a copy from the autorecovery file systems. 

The entire autorecovery process takes from 45 minutes to an hour. Most of this time is 
spent verifying each disk block. You can skip this phase by using the -b option of the 
esch command. 

Without this phase, autorecovery typically takes about 5 minutes, unless major system 
damage has occurred. See A/UX Local System Administration for a description of the 
file system checking routine (f sck). 



Autorecovery administration 

You must perform two key autorecovery administration tasks: 

□ Update the CML when key system files change. 

□ Update the autorecovery copies of key system files when they change. 

You perform these tasks with the escher, eu, and eupdate utilities, described in this 
section. 

The utilities escher and eu perform similar functions: both update the CML and the 
autorecovery file systems, but they use slightly different procedures. The utility 
eupdate copies the system files typically updated by autoconfiguration to the 
autorecovery file systems and updates the CML entries for these files. Each utility is 
described next and in A/UX System Administrator's Reference. 

eu utility 

The eu utility updates the CML and copies a specified file to the autorecovery file 
systems. The eu utility operates on only one file at a time and, like escher, requires a 
fully qualified pathname for the file to be copied. To run eu, enter the command 

eu pathname 

where pathname is the complete pathname of the file to be copied. A complete 
pathname always begins with a slash (/). 
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The eu utility has no interactive mode. As a rule, you should use eu to update the 
CML, because it creates entries with a checksum rule. The eu utility updates the CML 
even if the CML already contains an entry for the specified file. The escher utility 
updates the CML only if it does not already contain an entry for the file to be copied. 

You must be the superuser to run eu. 

escher utility 

The escher utility also adds new entries to the CML and copies the file to the 
autorecovery file systems. To run escher, enter the command 

escher pathname 

where pathname is the complete pathname of the file to be added. A complete 
pathname always begins with a slash (/). 

The escher utility examines the specified file and adds information about the file to 
the CML. As discussed in the manual page, escher does not use all possible CML 
rules when creating an entry; in particular, entries created with escher do not have a 
checksum rule. If you want a checksum rule, use the eu utility. "When the CML entry has 
been created, escher copies the file to both autorecovery file systems. 

You can also run escher interactively. In this mode, escher reads the CML and 
determines which files have been modified more recently than the copies in the 
autorecovery file systems. For each file that escher finds, it prompts you to decide 
whether the file should be copied to each of the two autorecovery file systems. When 
escher completes, the autorecovery file systems are current. 

You must be the superuser to run escher. 

eupdate utility 

The eupdate utility updates the CML entries for the files typically modified by 
autoconfiguration. To run eupdate, type the command 

eupdate 

The A/UX kernel (/unix) and other files necessary for multiuser network operation 
are copied to the autorecovery file systems. The CML entries for these files are also 
updated. 

You must be the superuser to run eupdate. 



2-8 Section 2: System Administration 



Administration guidelines 

To keep your autorecovery file systems current, follow these guidelines: 

□ Run escher -m often, to obtain a list of files that may need to be updated in the 
autorecovery file systems. You can schedule regular executions of escher -m with 
a crontab(l) entry. 

□ Whenever a key file is added to the system, use the eu or escher utility to update 
the CML. Autorecovery cannot recover files that do not appear in the CML. 

□ Run eu or eupdate as soon as key system files change. For example, if the 
autoconf ig command is run to build a new kernel, eupdate should be run as 
soon as the operation of the new kernel is verified. 

The escher and eu utilities may be used to add entries to the CML. Currently, no 
utility is available to delete CML entries. Use a text editor for this task. Consult the 
manual page for cml before attempting to update the CML manually. 

Troubleshooting 

This section discusses problems that occasionally occur when running autorecovery. 
Although autorecovery is fairly robust, it errs on the side of caution: autorecovery will 
not replace damaged or missing files if the copies on the autorecovery file systems or 
the autorecovery file systems themselves are suspect. This section presents the 
procedures to use when manual intervention is required to correct the operation of 
autorecovery. 

♦ Note: The procedures outlined here are for emergency use only. Normally, only 
autorecovery has access to the autorecovery file systems. Manual intervention 
should be kept to a minimum. The procedures recommended here use the pname 
utility. Users unfamiliar with this utility should consult the manual page for 
pname(lM) in AAJX System Administrator's Reference before continuing. 

This section is organized by symptom. Error messages or warning messages may 
appear as part of the problem description. When appropriate, they are included here. 

Symptom: One or both autorecovery file systems have inconsistent mount times. 

Symptom: Autorecovery fails during boot. 

Message: Warning. Inconsistent mount times in bzb. 

Message: esch: no consistent type FSTEFS 

BZB (ES_BZBS_FSTEFS) [error occurred in Block Zero 
Block module] 
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These messages may appear when autorecovery is run from the sash partition. 
Occasionally, autorecovery may be unable to restore damaged or missing files. 
Usually, this result occurs because autorecovery file systems were left mounted when 
the system was halted. After detecting this condition, autorecovery will not restore 
files from any autorecovery file systems that were left mounted when the system was 
interrupted. Autorecovery will not use these file systems because the integrity of the 
data is not guaranteed. If both autorecovery file systems were mounted when the 
system was halted, autorecovery cannot proceed. 

The most obvious sign that autorecovery has been interrupted is the message just 
listed. Autorecovery verifies that the unmount time is later than the mount time for 
each autorecovery file system. If an autorecovery file system has been left mounted, 
this test will fail and will generate the warning message. The autorecovery file systems 
that were left mounted when the system was halted must be checked for integrity. Use 
the following procedure to check the offending file system or systems. 

1 . Launch /unix from sash. Do not run autorecovery. 

2. At the sash prompt, enter the command 
launch /unix 

3 . When the system prompts you to check the root file system, type y. 

4 . Bring the system to single-user mode. 

5 . At the root prompt, enter the command 
pname -s3 "Eschatology 1" 

6 . At the root prompt, enter the command 
fsck /dev/dsk/c0d0s3 

The system will check one autorecovery file system for consistency. 

7 . At the root prompt, enter the command 
mount /dev/dsk/c0d0s3 /mnt 

8. Enter the command 
umount /mnt 

9. Enter the command 

pname -u /dev/dsk/c0d0s3 

10. Enter the command 

pname -s3 "Eschatology 2" 

1 1 . Enter the command 
fsck /dev/dsk/c0d0s3 

The system will check the second autorecovery file system for consistency. 
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12. Enter the command 

mount /dev/dsk/c0d0s3 /mnt 

13. Enter the command 
umount /mnt 

14. Enter the command 

name -u /dev/dsk/c0d0s3 

15. Enter the command 
sync ; sync ; reboot 
The system will restart. 

Autorecovery should now be operational. 

Symptom: escher or eu will not run. 

Message: Can f t lock cml file. 

Message: eu: Can't lock the fcml. Try again later. 

These messages are produced when both escher and eu are preparing to update the 
CML at the same time. The two utilities cannot be run at once, because each must have 
exclusive access to the CML. Users who receive this message should verify that either 
escher or eu is running, but not both. If neither escher or eu is running, the file 
/etc/eschatology/FCML . lock may be present. After verifying that no processes 
are attempting to update the CML, you may remove this file. 

Symptom: escher will not run. 

Message: /dev/dsk/cXXdYYsZZ previously pnamed 

Message: /dev/rdsk/cXXdYYsZZ previously pnamed 

These messages are produced when at least one device is still associated with an 
autorecovery file system. To remove the association, use the pname command by 
following these steps: 

1 . Enter the command 
pname 

The system will produce a display something like this: 

/dev/dsk/cOdOsO: "A/UX Root" "Apple_UNIX_SVR2" [not in ptab file] 
/dev/dsk/c0d0s3: "Eschatology 1" "Apple_UNIX_SVR2" [not in ptab file] 
/dev/dsk/c0d0s4 : "Eschatology 2" "Apple_UNIX_SVR2" [not in ptab file] 
/dev/dsk/c0d0s31: "Entire Disk" "Apple_UNIX_SVR2" [not in ptab file] 

2 . For each device associated with an autorecovery file system, issue the command 
pname -u device-name 
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For example, with the example just given, you enter the commands 

pname -u /dev/dsk/c0d0s3 

pname -u /dev/dsk/c0d0s4 

3 . Verify that no devices are currently associated with autorecovery file systems by 
entering 

pname 

again. The system produces a display something like this: 

/dev/dsk/cOdOsO: "A/UX Root" "Apple_UNIX_SVR2" [not in ptab file] 
/dev/dsk/c0d0s31: "Entire Disk" "Apple_UNIX_SVR2" [not in ptab file] 
The escher utility should now complete normally. 

Symptom: "Replaced" files missing after autorecovery completes. 

Message: replacing filename 

Message: filename was not replaceable . 

These messages are produced when autorecovery is run at boot time. When 
autorecovery determines that a file is invalid, it attempts to replace it with a valid copy 
from the autorecovery file systems. If the autorecovery file systems do not contain a 
valid copy of the file, it will not be replaced. Instead, autorecovery will remove it, 
because it has been identified as invalid. This situation is very unlikely, however, since 
it means that the CML contains an entry for the file, but the file has never been copied 
to either of the autorecovery file systems. Alternatively, the file may exist on the 
autorecovery file systems but fail the rules specified in the CML. Consistent use of the 
eupdate, eu, and escher utilities should prevent this problem from occurring. 

Autorecovery removes invalid files before attempting to replace them by design. 
Since autorecovery is concerned only with key system files, damage to these files could 
pose a security risk, especially in a network environment. For this reason, 
autorecovery removes files identified as invalid, whether or not a suitable replacement 
is available. 

Symptom: Some files cannot be copied to autorecovery file systems. 

Message: Ignoring filename - cmlfile entry incorrect 

When run interactively, escher produces this message. The escher utility will 
complain when the CML entry for the file to be copied contains an invalid rule 
specification, or when the CML fields are not separated by the correct number of tab 
characters. Manual editing of the CML is the most frequent cause of this condition. 

To recover, first make a backup copy of the CML. Then delete the offending entry from 
the CML with an editor. Use escher or eu to restore the entry to the CML and copy 
the file to the autorecovery file systems. 
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Section 3 



Network Administration 



This section explains how to configure your system for networking, using either TCP/IP 
only (BNET) or TCP/IP with the Network File System (NFS). The section also discusses 
how to set up your system to be a Yellow Pages client and how to bring up sendmail. 



EtherTalk card installation notes 

Before configuring A/UX, you should have an EtherTalk card installed. Complete 
installation instructions are provided when you purchase the card. Note, however, 
that you should examine the back end of your EtherTalk card before installation. On 
many cards, the R33 resistor may come into contact with the ferrite bead. This 
situation will cause shorting. Gently bend the resistor away from the ferrite bead, to 
prevent possible shorts. Figure 3-1 shows this process. 

Also, be especially careful if you are using thin Ethernet cable and must reposition the 
jumper on your card. If you have the shorting jumper block placed over the wrong two 
columns, you will select the wrong cable type. The EtherTalk card will try to send and 
receive on the wrong cable connector, and your Ethernet will not work. 
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Gently bend R33 away 
from the ferrite bead to 
prevent possible shorts. 




Ferrite bead 



Figure 3-1 

Preventing shorting of EtherTalk card 



If the jumper is over the wrong two columns, the Ethernet software driver in the A/UX 
kernel usually outputs an error message. The error message given commonly is 

aeO transmitter frozen — resetting 

Warning 

If you are using thin Ethernet cable, be sure that your T-shaped BNC connector is 
terminated. If your machine is at the end of the cable, there must be a 
termination cap on the leg of the connector that does not have a cable 
attached. 
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Configuring A/UX for TCP/IP (BNET) use (no NFS) 

To configure your system to communicate over TCP/IP but not NFS, follow these 
steps: 

1 . Log in as root, and bring the system down to single-user mode. 

2. Edit the file /etc/inittab to change the appropriate lines. In the following 
illustration of the file, the changed words appear in bold: 

sy : : sysinit : /etc/sysinitrc </dev/syscon >/dev/syscon 2>&1 

is : s : initdef ault : 

bl: :bootwait : /etc/bcheckrc </dev/syscon >/dev/syscon 2>&1 

be: :bootwait : /etc/brc </dev/syscon >/dev/syscon 2>Sl 

re: :wait : /etc/rc l>/dev/syscon 2>&1 

si : :wait : (rm -f /dev/syscon;ln /dev/systty /dev/syscon; ) l>/dev/systty 

2>&1 
pf : :powerfail : /etc/powerf ail l>/dev/syscon 2>&1 
er :2 :once: /us r /lib/err demon 

cr:2:once:/etc/cron </dev/syscon >/dev/syscon 2>&1 
lp:2 :once:/usr/lib/lpsched >/dev/syscon 2>&1 
co: :respawn : /etc/getty console co_9600 
tbO :2 :of f :/etc/toolboxdaemon > /dev/syscon 2>&1 
nf sO : 2 : wait : /etc/portmap 
nf si : 2 : off : /et c/ypserv 
nf s2 : 2 : off : /etc/ypbind 
nfs3:2:off :/etc/nfsd 4 
nfs4:2:off :/etc/biod 4 

nf s8: 2 :off: /etc/mount -at nfs > /dev/syscon 2>&1 
net4 : 2 : off : /etc/in . routed 
net5 : 2 : once : /usr/ etc/in . rwhod 
net8:2:off : /usr/lib/sendmail -bd -q30m 
net 9:2: respawn : /etc/inetd 
netO : 2 : off : /etc/named /etc/named. boot 
00 : 2 :off: /etc/getty ttyO at_9600 
01 : 2 :off: /etc/getty ttyl at_9600 

If you will be using a network with a gateway, also change the line 

net4 :2 :of f : /etc/in. routed 

to 

net4 :2 :wait : /etc/in .routed 
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3 . Enter the following commands to configure a BNET kernel: 

/etc/newunix bnet 

/etc/autoconf ig -u -v -o /unix -S /etc/startup 

The system responds with many lines of information. 

sync 
sync 
reboot 

4 . Bring the system back up, but do not run autorecovery. 

5 . After the reboot, the system prompts you for internet addresses and other related 
pieces of information. See "Selecting an Internet Address," below, for information 
on the way to answer these questions. 

6. Verify the operation of the new kernel and modified files. Run /etc/eupdate to 
update the autorecovery file systems correctly. 



Configuring A/UX for TCP/IP and NFS 

To configure your system to run TCP/IP and to be an NFS client or server, follow these 
steps: 

1 . Log in as root and bring the system down into single-user mode. 

2. Edit the file /etc/inittab as described previously in "Configuring A/UX for 
TCP/IP (BNET) Use (No NFS)." 

3. Make the following additional changes to /etc/inittab: 
If you plan to be an NFS server, change the line 
nfs3:2:off :/etc/nfsd 4 

to 

nf s3 :2 :wait : /etc/nf sd 4 

If you plan to be an NFS client, change the lines 

nfs4:2:off :/etc/biod 4 

nf s8 :2 : of f: /etc/mount -at nfs > /dev/syscon 2>&1 

to 

nf s4 :2 :wait : /etc/biod 4 

nfs8 : 2 :once : /etc/mount -at nfs > /dev/syscon 2>&1 

Regardless of whether you are a server or a client, if you will be using a network with a 
gateway, also change the line 

net4 : 2 : off : /etc/in . routed 

to 

net 4 :2 : wait : /etc/in . routed 
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4 . Enter the following commands: 

/etc/newunix nfs 

/etc/autoconf ig -u -v -o /unix -S /etc/startup 

The system responds with many lines of information. 

sync 
sync 
reboot 

5 . Bring the system back up, but do not run autorecovery. 

6 . After the reboot, the system prompts you for internet addresses and other related 
pieces of information. See "Selecting an Internet Address," below, for information 
on how to answer these questions. 

7. Verify the operation of the new kernel and modified files. Run /etc/eupdate to 
update the autorecovery file systems correctly. 



Configuring A/UX as a Yellow Pages client 
with either BNET or NFS 

To configure A/UX as a Yellow Pages client, follow these steps: 

1 . Edit the file /etc/inittab and change the line 
nf s2 : 2 : off : /etc/ypbind 

to 

nf s2 : 2 :wait : /etc/ypbind 

2. Add the following line to the end of the /etc/passwd file: 
+ : : : : : : 

3 . Add the following line to the end of the /etc/group file: 
+ : : : 



Selecting an internet address 

This section explains how to select the various names and numbers needed by A/UX to 
run on a network. You set these names and numbers by responding to questions asked 
during the configuration of A/UX for network use, as described earlier. 
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Host name 

You must name your A/UX system. Every A/UX system on the Ethernet must have a 
name by which it is known on the network. This name is the host name. A host name 
should be from 1 to 8 characters long. 

You should have set your host name when you first brought your system up. (See your 
A/UX Installation Guide for details.) If you wish to change your host name now, edit 
the file /etc/HOSTNAME. (See the manual page for H0STNAME(4) in A/UX 
Programmer's Reference.') In this example, the host name is golden. 



Internet address 

The internet address is a number that is unique to each system on the network. If you 
think of the host name as being like your name, such as John Smith, then the internet 
address could be like your home address, 1234 Main Street. 

An internet address is 32 bits, or 4 bytes, in length. The 4 bytes are separated by 
periods (for example, 192.33.20.34). There are three classes of internet address, 
known as A, B, and C. These classes differ in the number of bytes taken up by the 
network number and the number of bytes available for the host numbers. This section 
describes class C addresses only. 

In a class C address, the first 3 bytes constitute the network number (in the example just 
given, 192.33.20), which is shared by all machines on a given network. The remainder 
of the address (34) is the host number, which is unique for each machine on the 
network. 

You must inform your system of its internet address, as well as its site-specific 
broadcast address and netmask (if any). Your broadcast address is formed like any 
other internet address, except that the host number is either or -1 (entered as or 
255, respectively) for a class C address. 

Warning 

You should check with your system administrator or network administrator to 
obtain an internet address for your machine. If you have no network 
administrator, you should use the network number given in the next example. Be 
sure that all machines on your network share the same network number but 
have unique host numbers. 
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These instructions apply only to networks that do not have a network administrator and 
that use these instructions for all systems on the network. If you wish to install your 
system in a network where not everyone is following these instructions, you must get 
your internet address from a system administrator or network administrator. If you 
think you may connect your network to another network in the future, obtain an 
official, registered network number by calling 

Hostmaster 
(800) 235-3155 



Example 

The following example assigns a class C network number and host number to the 
machine with host name golden. The example uses the default netmask, implying a 
non-subnetted environment. The range of possible host numbers for a class C address 
is 1 to 254. Host number 34 is assigned to golden. The network number for this class C 
network is 192.33.20. 

Before assigning an internet address to your system, you must reconfigure the kernel 
for either TCP/IP-**only (BNET) or NFS support, as described in the earlier parts of 
this section in "Configuring A/UX for TCPAP (BNET) Use (No NFS)" or in 
"Configuring A/UX for TCP/IP and NFS." When the new A/UX kernel finds an 
EtherTalk card for the first time, it prompts for the internet address. The dialog 
proceeds as follows (user responses are in bold type): 

loO: 127.0.0.1 netmask ff 000000 f lags=42KUP,NOTRAILERS, LOOPBACK> 

1 Ethernet card(s) installed 
aeO: Please enter an Internet address: 192.33.20.34 <Return> 
aeO: Please enter an Internet Broadcast address: 192.33.20.255 <Returs> 
aeO: Please enter a netmask [none]: <Return> 
aeO: hostname is golden with IP address of 192.33.20.34 broadcasting with 

192.33.20.255 
aeO: 192.33.20.34 netmask ffffffOO flags=63<UP, BROADCAST, NOTRAILERS,RUNNING> 
broadcast: 192.33.20.255 

If you wish to change these values at a future date, edit the file /etc/NETADDRS. (See 
the manual page for NETADDRS(4) in A/UX Programmer's Reference.') 

For more information on network classes, as well as netmasks and subnetted 
environments, see your network administrator or consult the appropriate RFCs 
available from 

The NIC (Network Information Center) 
333 Ravenswood 
SRI International 
Menlo Park, CA 94025 
(415) 326-6200 
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For additional information on setting up and administering a networked Macintosh II, 
see AAJX Network System Administration, available through the Apple 
Programmer's and Developer's Association (APDA): 

Apple Programmer's and Developer's Association 

290 SW 43rd Street 

Renton, WA 98055 

(206) 251-6548 

AppleLink: APDA 

MCI: 321-7449 

CompuServe* 73527,27 



Configuring sendmail 

This section describes how to bring up sendmail. More complete information 
appears in AAJX Network System Administration, available through the Apple 
Programmer's and Developer's Association (APDA). 

AAJX is shipped with all the normally needed aliases, such as postmaster. If you 
wish to modify the aliases, edit the file /usr/ lib/aliases. If you change the 
aliases, you must run /usr/ucb/newaliases before the changes will be visible to 
sendmail. For more information, see the manual page for aliases(4). 

AAJX is also shipped with a default configuration file (/usr/ lib/ sendmail . cf), 
which is appropriate for most sites. It should, however, be frozen so that sendmail 
will start up faster. You can freeze the file by executing 

/usr/lib/sendmail -bz 

If you desire to change the default configuration, you can find more information in 
A/UX System Administrator's Reference under sendmail(lM). 

To have sendmail run as a standard process when the system boots, change 

net8 : 2 :off: /usr/lib/sendmail -bd -q30m 
in /etc/inittab to 

net8 : 2 :once: /usr/lib/sendmail -bd -q30m 

You may also wish to reduce the interval for processing the messages in the queue. 
This value is currently set at 30 minutes. Change the value shown in bold here: 

net8 :2 :once : /usr/lib/sendmail -bd -q30m 
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Section 4 



Adding Extra 
Hard Disk SCs 



Apple Computer makes three external SCSI hard disks for increasing your system's 
mass storage capability: the HD 20SC, the HD 40SC, and the HD 80SC. You can use 
any of these disks for mounting an A/UX file system or for storing files and 
applications accessible from the Macintosh Operating System. In addition to the Hard 
Disk SC that contains A/UX, you can add up to six more hard disks by attaching them 
to the SCSI port on your Macintosh II computer. 

Chapter 8 of the A/UX Installation Guide refers to several guides that can help you add 
disk storage to your system. This release note has been prepared since the A/UX 
Installation Guide went to press to offer you comprehensive instructions for attaching 
and configuring Apple Hard Disk SCs to an A/UX system. 

As long as you're adding Hard Disk SCs from Apple Computer to your system, this 
document alone should be sufficient in providing you with all the installation and 
troubleshooting information you need. For additional setup information, you might 
still wish to refer to the Apple SCSI Cable System and to the owner's guide for your 
Hard Disk SC. 

To add an Apple Hard Disk SC to your system, you need the following components: 

□ an Apple Hard Disk SC 

□ the Hard Disk SC Setup disk (shipped with each Apple Hard Disk SC) 

□ a Hard Disk SC power cord 

□ an Apple SCSI System Cable 

□ an Apple SCSI Cable Terminator 

If you're adding more than one external hard disk to your system, you need a SCSI 
Peripheral Interface Cable for each additional Hard Disk SC. Figure 4-1 identifies 
these items for you. 
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♦ Note: Do not attach your external Hard Disk SC to your computer or plug the power 
cord into the Hard Disk SC until you're instructed to do so. 



SCSI Peripheral Interface Cable 
(required when connecting more 
than one external Hard Disk SC) 




Apple Hard Disk SC 

Hard Disk SC power cord 
SCSI Cable Terminator — 
SCSI System Cable 
Hard Disk SC setup disk 



Figure 4-1 

Hard Disk SC and SCSI components 



Attaching Hard Disk SC hardware 

This section describes how to connect external Hard Disk SCs, their cables, and 
terminating resistors (in the form of SCSI Cable Terminators) to the Macintosh II 
computer. 

1 . Shut down A/UX, and turn off the Macintosh II and any attached SCSI devices. 

The procedures for shutting down and switching off the Macintosh II are explained 
in detail in Chapter 6 of the A/UX Installation Guide and Chapter 2 of A/UX Local 
System Administration. In brief, these procedures are as follows: 

□ Log in as root. 

□ Use the shutdown command to return to single-user mode. 

□ Enter the sync command at least twice. 

□ Enter the power down command to turn off the Macintosh II. 

D If you have any SCSI devices connected to your system, switch them off now. 

2. Touch any one of the metal connectors on the back of your computer. 

Doing this discharges any static electricity that may be on your body or clothes. 
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3. Decide upon a unique SCSI ID number for the additional Hard Disk SC. 
(Normally, use 5 for the first external hard disk and 6 for the second.) 

The SCSI standard lets you connect up to seven peripheral devices to form a SCSI 
chain. In order to establish a communication path, each device must have a unique 
SCSI ID number, which designates the priority and logical location of a device on 
the SCSI chain. The SCSI ID number identifies each peripheral device regardless of 
its physical location in your SCSI chain. 

You must assign a unique SCSI ID number to each Hard Disk SC you add to your 
system. Your Macintosh II is always assigned ID number 7. By convention, the 
internal hard disk uses SCSI ID number 0, the first external hard disk uses SCSI ID 
number 5, and the second external hard disk uses SCSI ID number 6. For any 
additional peripheral devices, use the remaining SCSI ID numbers to organize your 
SCSI chain. 

4. Set the SCSI ID for the additional Hard Disk SC. 

After you have chosen a unique SCSI ID, set your Hard Disk SC to that number. (See 
Figure 4-2 for the location of the SCSI ID number switch and SCSI ID number 
indicator.) 

□ Make sure the power cord is not connected to the additional Hard Disk SC so that 
it cannot possibly be turned on. 

□ Insert the point of a pin or straightened paper clip into the SCSI ID number 
switch on the back of the Hard Disk SC. 

□ Push gently. The number increases. 

□ If you go past the number you want, keep pushing until the number cycles around 
again. 



SCSI ID number indicator 



SCSI ID number switch 




Figure 4-2 

SCSI ID number indicator and switch 



Attaching Hard Disk SC hardware 
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5. If you are now adding the very first external Hard Disk SC to your system, skip 
this step and proceed instead to step 6. 

However, if you already have one or more external Hard Disk SCs connected to 
your Macintosh II, follow these steps and refer to Figure 4-3 to add another hard 
disk. 

□ Disconnect the 50-pin connector of the System Cable from the SCSI connector 
on an existing external Hard Disk SC, and attach a 50-pin connector of the 
Peripheral Interface Cable in its place. Press the diamond-shaped wire clips 
toward the Peripheral Interface Cable connector, and then snap them into the 
clip brackets to secure the connection. 

□ Attach the other end of the Peripheral Interface Cable to either SCSI connector 
on the new Hard Disk SC. Snap the clips into the clip brackets. 

□ Attach the free end of the System Cable to the available connector on the new 
Hard Disk SC. Snap the clips into the clip brackets. 

□ Make sure that the Cable Terminator is connected to the Hard Disk SC at the end 
of the SCSI chain. 

Note that the end of the SCSI chain is not necessarily the disk with the highest 
SCSI ID number. The Macintosh II with an internal hard disk is at the beginning 
of the SCSI chain; the Hard Disk SC at the opposite end of all cabled devices is 
considered to be the end of the SCSI chain. 



Existing external HD SC 
Cable Terminator 
Peripheral Interface Cable 
New external HD SC 
System Cable 




Figure 4-3 

Attaching two external Hard Disk SCs 
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Warning 

A Cable Terminator must always be connected to the peripheral device at the 
physical end of the SCSI chain. 

□ If your system has an internal hard disk installed, skip both the remainder of this 
step and step 6, and proceed now to step 7. 

However, if your system has A/UX on an external Hard Disk SC and has no internal 
hard disk at all, you must ensure that both your new Hard Disk SC and your Hard 
Disk SC that contains A/UX have Cable Terminators attached. This setup is 
necessary because the SCSI system requires terminating resistors on the first and last 
devices in the SCSI chain. Apple internal hard disks have terminating resistors 
built-in; Apple external Hard Disk SCs do not. Instead, you must use Cable 
Terminators as terminating resistors for external Hard Disk SCs. 

Therefore, to attach a second external Hard Disk SC when there is no internal hard 
disk installed, perform the following additional steps. 

□ Disconnect the System Cable from its SCSI connector on the Hard Disk SC. 

□ Attach a Cable Terminator to the 50-pin connector of the System Cable, as shown 
in Figure 4-4. Snap the clips into the clip brackets to secure the connection. 




Cable Terminator 
System Cable 



Figure 4-4 

Attaching the Cable Terminator to the System Cable 
(only when there is no internal hard disk) 

□ Attach the Cable Terminator, which is already attached to the System Cable, to 
the available SCSI connector on the Hard Disk SC. Snap the clips into place to 
secure the connection. Both of your external Hard Disk SCs should now have 
Cable Terminators attached, and a Peripheral Interface Cable should connect the 
disks. 

D For future reference, use a pencil or a pen to draw an arrow that redirects you from 
the beginning of step 5 to the steps given next. If you add more external Hard Disk 
SCs or other SCSI devices to your system, you should skip the previous 
instructions in step 5 and follow those given next instead. 
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If you attach more external SCSI devices in the future, keep your current Hard Disk 
SCs as the first and last devices in the SCSI chain, as they already have Cable 
Terminators attached. Replace all of step 5 with the following instructions. 

□ Disconnect the Peripheral Interface Cable from the SCSI connector on the Hard 
Disk SC at either end of the SCSI chain. Note that the ends of the SCSI chain are 
not the necessarily the disks with the highest or lowest SCSI ID numbers; rather, 
they are the disks at the physical ends of all connected SCSI devices, and 
therefore ought to have Cable Terminators already attached. 

□ Reattach the free end of the Peripheral Interface Cable to either of the available 
SCSI connectors on your new SCSI device. 

□ Attach one end of a new Peripheral Interface Cable to the last available SCSI 
connector on your new SCSI device. 

□ Finally, attach the free end of the new Peripheral Interface Cable to the available 
SCSI connector on the Hard Disk SC at the physical end of the SCSI chain. 

To continue your Hard Disk SC setup, skip step 6 and proceed to step 7 instead. 

6. If you are attaching your very first external Hard Disk SC to Ihe system, follow 
these instructions. 

If you already have one or more external Hard Disk SCs attached, you should 
have followed step 5 above; in which case, you should now skip this step and 
proceed instead to step 7. 

a Attach the 25-pin connector of the SCSI System Cable to the SCSI connector on 
the back of your Macintosh II, as shown in Figure 4-5. When connecting the 
System Cable, press the diamond-shaped wire clips toward the connector, and 
then snap them into the clip brackets to secure the connection. 
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Figure 4-5 

Attaching the System Cable to the Macintosh II SCSI connector 
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Warning 

Attach only the SCSI System Cable to the SCSI connector on the computer. To 
identify the connector, look for the SCSI icon, shown in Figure 4-6, on the rear 
panel of the computer. 

Putting another type of cable, such as an RS-232 connector, in the SCSI 
connector can seriously damage the SCSI chip inside your computer or the 
computer itself. 




Figure 4-6 

SCSI connector icon 

□ Tighten the thumbscrews on the DB-25 connector. 

a As shown in Figure 4-7, attach the 50-pin connector of the SCSI System Cable to 
either of the SCSI connectors on the back of the external Hard Disk SC. 




Figure 4-7 

Attaching the SCSI System Cable to the Hard Disk SC 

a Attach the Cable Terminator to the available SCSI connector on the external 
Hard Disk SC, as shown in Figure 4-8. Snap the clips into the clip brackets to 
secure the connection. 
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Warning 

A Cable Terminator must always be connected to the peripheral device at the 
physical end of the SCSI chain. 




Figure 4-8 

Ending the SCSI chain with a Cable Terminator 



With all peripheral devices attached to your computer system and switched 
off, attach the power cord to the Hard Disk SC and plug it into a grounded 
(three-prong) AC outlet. 

The power switch for all Hard Disk SCs is located to the right of the power receptacle 
on the back of the device. Press the bottom of the switch to make sure the device is 
off. 



Warning 

This equipment Is intended to be electrically grounded. 

Apple computers and peripheral devices are equipped with three-wire grounding 
plugs— plugs that have a third (grounding) pin. These plugs will fit only 
grounding-type AC outlets. This is a safety feature. 

If you are unable to insert the plugs into the outlets, contact a licensed 
electrician to replace the outlets with properly grounded outlets. 

Do not defeat the purpose of the grounding plug! 
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8. Arrange your components, keeping your external Hard Disk SC away from 
the front left side of the Macintosh II main unit, and allow adequate 
ventilation around all components. 

Keep external Hard Disk SCs away from the front left side of the computer where 
they risk magnetic interference from the Macintosh IPs power supply. 

To ensure proper ventilation while the Hard Disk SC is on, be sure not to block the 
air vents at the sides and the back of the unit. 



Warning 

Protect your system from overheating by keeping at least 4 inches clear around 
all sides of your external Hard Disk SCs and your computer's main unit. Always 
keep Hard Disk SCs and the main unit flat. Standing them on edge or not allowing 
room for air to circulate will defeat their cooling design and may eventually 
damage them. 



9. Switch on the external Hard Disk SCs with Cable Terminators attached. 

You need to switch on the peripheral devices that have terminating resistors 
attached (the first and last peripheral devices in the SCSI chain) to allow 
information to pass through the cable system. Begin by turning on the 
Hard Disk SC with the Cable Terminator attached. 

When you turn on your Macintosh II in a few minutes, the internal hard disk, which 
has a terminating resistor built in, is automatically turned on. However, if your 
system does not have an internal hard disk, turn on the other external 
Hard Disk SC that has an attached Cable Terminator. 

10. If you have additional SCSI devices attached, switch them on now. 

If you aren't using a device in the middle of the SCSI chain, you can leave it 
switched off. 



Using an external Hard Disk SC for the Macintosh OS 

If you are adding an external Hard Disk SC that already contains Macintosh files 
and you want to access them through the Macintosh OS, skip the next section, 
"Initializing Your Hard Disk SC," and proceed instead to the section "Using a 
Hard Disk SC With the Macintosh OS." Otherwise, initializing your disk will erase 
all of its current Macintosh data. 

If you're adding a new disk that does not contain any data, you must follow the 
instructions in the section "Initializing Your Hard Disk SC," regardless of whether 
you want it to store Macintosh OS or A/UX files. 
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1 1 . If your disk is new, or if you used it for other operating systems and now you 
want it to contain an A/UX file system, follow the steps in the next section to 
initialize your Hard Disk SC. 



Initializing your Hard Disk SC 

To use the Hard Disk SC, you must initialize the disk — that is, prepare it to receive 
information by organizing its surface into tracks and sectors. This section describes 
how to use the Apple HD SC Setup program to initialize your new disk. 

If you have a disk that you've already used with the Macintosh OS or with an Apple II, 
and if you want to use it for A/UX now, you should initialize it as described in this 
section. However, back up the data on that disk before continuing with these 
instructions. It is important to back up your data because reinitializing the disk erases 
all of its current information. To back up your disk, use a utility like the HDBackup 
application, which is found on the Utilities disk that was shipped with your Macintosh II 
computer. 

1 . Insert the Hard Disk SC Setup disk into either of the 3.5-inch internal disk drives 
on your Macintosh II. 

The 3.5-inch Hard Disk SC Setup disk was shipped with your Hard Disk SC. 

Every Macintosh II has at least one 3.5-inch internal disk drive; your system may 
have two. 

2. Turn on your Macintosh II. 

Press the Power On key on the keyboard. The 3- 5-inch internal disk drives have 
startup priority over SCSI disk drives. Therefore, because the Hard Disk SC Setup 
disk is in the internal disk drive and because it contains Macintosh startup files, the 
Macintosh II starts up from this disk instead of from the A/UX disk. 

3. Double-click the Hard Disk SC Setup icon to open it. 

Use the mouse to move the pointer to the disk icon labeled Hard Disk SC Setup on 
the right side of your screen as shown in Figure 4-9. Double-click on the icon by 
quickly pressing and releasing the mouse button twice. On your screen a window 
opens that shows a System Folder, a Utilities Folder, and the Apple HD SC Setup 
application icon. 
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Hard Disk SC Setu 



Figure 4-9 

Double-clicking Hard Disk SC Setup 



4. Double-click the icon of the Apple HD SC Setup application. 

Figure 4-10 shows the icon. After you open the application, a dialog box appears, as 
shown in Figure 4-11. 



Figure 4-10 

Double-clicking Apple HD Setup 
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Figure 4-11 

The Apple HD SC Setup dialog box 

Next to the words "SCSI Device" in the dialog box is a number from to 6. If you 
have only one external Hard Disk SC, the preset priority number of the drive 
automatically appears as the SCSI device number. 

If you have two or more external SCSI devices connected, make sure that this 
number matches the SCSI ID number of the Hard Disk SC you want to initialize. If 
the numbers do not match, use the mouse to move the pointer to the Drive button 
on the screen and clicking (that is, pressing and releasing the mouse button) until 
the SCSI numbers do match. 
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Warning 

Make sure that you have chosen the Hard Disk SC you want to initialize, and not 
some other hard disk. Initializing destroys all information on the hard disk. 

5. Click Initialize, as shown in Figure 4-12. 



Initialize! 



Figure 4-12 

Clicking Initialize 



After you click the Initialize button, another dialog box appears, reminding you that 
initializing erases all the information from the Hard Disk SC. To continue, click OK 
as shown in Figure 4-13. 




Figure 4-13 

Clicking OK 

Messages appear in the Setup window, explaining the course of the initialization. 
Initialization takes several minutes. The length of time depends on the size of your 
Hard Disk SC. 

If you see a message that the Hard Disk SC failed to initialize properly, try again. If 
you are still unable to initialize, there may be a hardware problem. See your 
authorized Apple dealer. 

6. Name the disk. 

A message tells you when initializing has been successfully completed and asks you 
to name the disk. This name identifies the disk under the Macintosh OS. However, 
A/UX won't use the name you give here. 

You can click OK and leave the disk untitled if you plan to use the disk for storing an 
A/UX file system. However, if your site has multiple Hard Disk SCs, you may find it 
helpful to give the disk a name, especially if you share Hard Disk SCs among several 
Macintosh computers. 
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You can type up to 27 characters, and you can use any keyboard character except 
the colon (:). However, the disk name should not begin with a period. Press the 
RETURN key when you are sure you have entered the right name. 

7. Click Quit, as shown in Figure 4-14. 




Figure 4-14 

Clicking Quit 

Clicking Quit returns you to the Finder™ Desktop, where the Hard Disk SC icon 
appears with the name you gave it. 

8. Choose Restart from the Special menu. 

Use the mouse to move the pointer to Special in the menu bar at the top of the 
screen. Press the mouse button so that Special is highlighted and a menu of 
commands appears. Hold the mouse button down and drag the mouse downward 
until the command Restart is highlighted. Then release the mouse button. 

This process causes the Macintosh II first to eject all 3.5-inch disks from their 
drives, and then to search for the Startup Device. This device will normally be the 
disk containing A/UX, in which case the sash application is launched and begins 
counting down the seconds before booting A/UX. 



Special 



Clean Up Window 
£mp*y Trash 
Erase Disk 
Set Startup... 




Figure 4-15 

Choosing Restart from the Special menu 

(If you used the Control Panel desk accessory to change the Startup Device, start 
sash now by double-clicking its icon.) 
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9. If you want to use this disk for Macintosh OS files, interrupt the automatic boot 
procedure and then read the next section, "Using a Hard Disk SC With the 
Macintosh OS." 

Cancel the automatic boot by performing either of the following: 

□ clicking the Cancel button on the screen 

□ holding down the Command key (marked with an Apple icon and a cloverleaf 
icon) and type a period ( . ) 

10. If you want to use this disk for an A/UX file system, let A/UX boot 
automatically, skip the next section, and proceed to the section following 
titled "Partitioning a Hard Disk SC for an A/UX File System." 



Using a Hard Disk SC with the Macintosh OS 

This section is intended to help you use your newly attached external Hard Disk SC for 
Macintosh Operating System access. 

If you connected a Hard Disk SC that already contains Macintosh OS files, make sure 
that the Hard Disk SC is turned on, and then press the Power On key on the 
Macintosh II keyboard. When the A/UX automatic boot screen appears, cancel the 
A/UX boot by performing either of the following: 

□ clicking the Cancel button on the screen, as in Figure 4-16 

□ holding down the Command key (marked with an Apple icon and a cloverleaf icon) 
and typing a period ( . ) 



Rutomatic Boot 

Will launch fl/UH kernel in 

10 

seconds. 



Cancel 



GD 



Figure 4-16 

Clicking Cancel 
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If you just finished initializing your Hard Disk SC, you should have already interrupted 
the A/UX automatic boot as described earlier. 

You should find the sash# prompt on your screen. The rest of this section provides 
instructions for switching between the two operating systems — A/UX and the 
Macintosh OS — on your computer. 

However, if you didn't interrupt the A/UX automatic boot, let A/UX boot to single- 
user mode; refer to the instructions in "Returning to the Macintosh OS From A/UX" 
later in this section for assistance in bringing down A/UX and restarting your 
computer under the Macintosh Operating System. 



Deciding which disk to use as the Startup Device 

Since you're dedicating this additional Hard Disk SC for the Macintosh Operating 
System, you need to consider the order in which the SCSI devices are accessed when 
the Macintosh II starts up. The Macintosh II automatically looks for Macintosh OS 
startup files in the following places and in the following order: 

1 . Internal 3.5-inch disk drive number 

2. Internal 3.5-inch disk drive number 1 

3 . A Macintosh Hard Disk 20 (a serial, not a SCSI, device) 

4 . The SCSI hard disk with the highest SCSI ID number, or the hard disk set as the 
Startup Device with the Control Panel desk accessory 

5 . Another hard disk with the next-highest SCSI ID number 

The A/UX Stand-Alone Shell (sash) is a Macintosh application in a Macintosh 
partition on the factory-loaded A/UX Hard Disk SC. This disk is initially configured to 
be the Startup Device. Therefore, unless you change the Startup Device with the 
Control Panel desk accessory, the Hard Disk SC that contains A/UX is always started 
first. In this case, the sash application — being the startup application on this 
disk — automatically tries to boot A/UX whenever you turn on or restart the 
Macintosh II. 

Alternatively, if you want the Macintosh OS instead of A/UX to come up automatically 
when you turn on or restart your Macintosh II, change the Startup Device to be the new 
disk containing the Macintosh OS by performing the following. 

D Make sure there is Macintosh system software (contained in a System Folder) on the 
Hard Disk SC dedicated to the Macintosh OS. Refer to "Installing System Software" 
in Appendix A of your Macintosh II owner's guide for information about installing 
and updating system software on your extra Hard Disk SC. 
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d Use the Control Panel desk accessory to set the Startup Device to be the 

Hard Disk SC dedicated to the Macintosh OS. Refer to "Using the Control Panel" in 
Chapter 3 of your Macintosh II owner's guide for instructions. Remember that the 
Hard Disk SC containing A/UX is called sash partition; the Hard Disk SC 
dedicated to the Macintosh OS has the name you gave it when you initialized the 
disk. 



Restarting A/UX from the Macintosh OS 

Whenever you are ready to restart A/UX, quit and save all of the work you've been 
doing under the Macintosh OS. 

If sash is the startup application on your system and if sash is configured to boot 
A/UX from the correct disk, you can automatically boot A/UX by using the mouse to 
select Restart — either from the Special menu under the Macintosh Finder or from the 
Execute menu under the sash application. 

In any case, you can always boot A/UX by performing the following set of procedures. 

□ If the disk sash partition is not already open, open it by double-clicking it with 
the mouse as shown in Figure 4-17. 



sash partition 
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Double-clicking sash partition 

□ If the sash application is not already running, start it by double-clicking its icon, 
shown in Figure 4-18. The sash application counts down and then boots A/UX to 
single-user mode. 




sash p^ 

Figure 4-18 

The sash icon 

If you cancel or interrupt the automatic boot procedure, you can start A/UX by 
entering the command boot at the sash# prompt or by using the mouse to select 
Boot from the Execute menu. Then follow the A/UX startup procedures described 
in either the A/UX Installation Guide or the A/UX Local System Administration to 
bring the system up to multiuser mode. 
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Returning to the Macintosh OS from A/UX 

To access the files under the Macintosh Operating System, you must bring down A/UX 
and restart the system. Unless you configured the disk containing the Macintosh OS as 
the Startup Device, you must then interrupt the A/UX automatic boot and quit the 
sash application. 

Shutting down A/UX from single-user mode 

If your system is already booted and running A/UX in single-user mode, bring A/UX 
down by 

□ entering the killall command to stop all active processes 

□ entering the sync command at least twice to flush the system buffers 

□ entering the reboot command 

□ interrupting the automatic boot either by clicking the Cancel button on the screen, 
or by holding down the Command key (marked with an Apple icon and a cloverleaf 
icon) and typing a period ( . ) 

Note that if you configured the disk containing the Macintosh OS as your startup 
device, you will automatically start up under the Macintosh OS and you won't need to 
cancel the A/UX automatic boot as just described. 

Shutting down A/UX from multiuser mode 

If your system is already booted and running A/UX in multiuser mode, bring A/UX 
down by 

□ entering the shutdown command to return to single-user mode 

□ entering the sync command at least twice to flush the system buffers 

□ entering the reboot command 

□ interrupting the automatic boot either by clicking the Cancel button on the screen, 
or by holding down the Command key (marked with an Apple icon and a cloverleaf 
icon) and typing a period ( . ) 

Note that if you configured the disk containing the Macintosh OS as your startup 
device, you will automatically start up under the Macintosh OS and you won't need to 
cancel the A/UX automatic boot. 

Quitting sash 

When you cancel the A/UX automatic boot procedure, you will be in the sash 
application. To exit to the Macintosh Finder, quit sash by selecting Quit from the File 
menu as explained here. 
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□ Use the mouse to move the pointer to File in the menu bar at the top of the screen. 

□ Press the mouse button so that File is highlighted and a menu of commands 
appears. 

□ Hold the mouse button down and drag the mouse downward until the command 
Quit is highlighted. 

□ Release the mouse button. 

Instead of using the mouse, you can also quit sash by holding down the Command key 
(marked with an Apple icon and a cloverleaf icon) and typing q. 



f. lose 



Quit 



Figure 4-19 

Quitting sash 

You then see the Finder Desktop under the Macintosh Operating System. Icons for 
your attached disks appear on the right side of the screen. To begin using your new 
disk, open it by double-clicking its icon. (Refer to your Hard Disk SC owner's guide or 
your Macintosh II owner's guide for information about setting up files and folders on 
this disk.) 

Since you're using the disk for the Macintosh OS, you can skip the rest of this 
document, which describes how to configure the Hard Disk SC and A/UX for accessing 
A/UX file systems from an external Hard Disk SC. 



Partitioning a Hard Disk SC for an A/UX file system 

A hard disk can be divided into logical sections, called partitions, to accommodate 
multiple file systems and even multiple operating systems. For example, the A/UX 
distribution disk contains one partition for the Macintosh OS, one for the A/UX root 
file system, one for A/UX process paging, and two for storing redundant copies of 
important files so that Autorecovery can help restore a corrupted system to a good 
state. However, creating multiple partitions on a disk is a complex and difficult 
procedure. 

Creating a disk partition consists of setting the partition's attributes and establishing a 
mapping from the partition's logical address to the disk's physical address. You use 
the dp utility to change or create a disk partition for A/UX. 
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To avoid the complications of creating multiple partitions on a single disk, this section 
describes the simplest case: partitioning the entire disk for a single A/UX file system. 
This configuration should serve the needs of the vast majority of users. However, if you 
wish to investigate more elaborate partitioning schemes, read this section and then 
read dp(lM) and pname(lM) in A/UX System Administrator's Reference. However, 
consider yourself warned: creating multiple partitions might require more work than 
they're worth. 



A/UX device names for Hard Disk SCs 

The rest of this documentation makes extensive reference to the A/UX device names 
used by the Hard Disk SCs. A/UX names Hard Disk SCs according to the following 
convention: 

/dev/dsk/cwdms_y 

The directory /dev lists all of the devices under A/UX. The subdirectory dsk lists all 
of the block devices; that is, those like the Hard Disk SCs from which you can mount 
A/UX file systems. 

The value of n after c is the SCSI ID of the Hard Disk SO, the value of m after d is the 
number of the sub-drive at that SCSI ID; and y after s refers to the slice, or partition, 
on that disk. 

Some controller boards support multiple disk drives off one SCSI ID, and m selects 
that second drive. However, all of the Hard Disk SCs that you connect to the 
Macintosh II through its built-in SCSI port have separate SCSI ID numbers; none will 
be identified as sub-drives. For example, the internal hard disk on a Macintosh II is 
identified by the device name /dev/dsk/cOdOs.y; the first external Hard Disk 
SC — when given SCSI ID number 5, as is the convention — is identified as 
/dev/dsk/c5d0s.y. 

The slice number, y, identifies a partition on the disk. Slice always refers to the root 
partition, and slice 31 always refers to the entire disk. 

On Hard Disk SCs that you add to the system, slice 1 is normally used for the swap 
partition (for temporarily storing portions of processes awaiting execution), and 
slice 2 is normally used for a usr partition (typically for storing a user file system.) 

♦ Note: If you use dp to create partitions on slices other than 0, 1, or 2, you must use 
pname(lM) to associate these partitions with A/UX device nodes. 
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Using dp to remap the Hard Disk SC partition 

A Macintosh-type partition was created on your disk when you initialized it with the 
Apple HD Setup utility. In this section, you'll use dp to remap that partition as an 
A/UX file system. 

1 . Boot A/UX to multiuser mode. 

Let the automatic boot procedure of the sash application bring A/UX up to single- 
user mode. Of A/UX does not come up in single-user mode, refer to the next page 
for assistance.) Then enter the command init 2 to bring A/UX up to multiuser 
mode. 

(The entire startup procedure is described in detail in Chapter 2 of AAJX Local 
System Administration and Chapter 6 of the A/UX Installation Guided 

2. Log in as root. 

You'll need superuser privilege to use several of the following commands. 

3. Use the dp utility to examine the current partition map and partition 
attributes. 

□ Replacing n with the SCSI ID number of the new Hard Disk SC, enter the following 
command: 

dp /dev/dsk/cwd0s31 

The dp utility returns a message informing you of the partition created on that 
disk when you ran the Macintosh Hard Disk SC Setup program. The dp utility 
then prompts you for a command. For example, if you are partitioning a disk 
with SCSI ID number 6, the following message appears: 

"/dev/dsk/c6d0s31" 1 partitions, 1 allocated [unknown size] 
Command? 

♦ Note: If you get a different response, enter an uppercase Q to quit dp. Reenter 
the dp command just given, making sure you specify the correct SCSI ID and 
that you type the command correctly. 

When using dp, you can quit at any time without making any changes by entering 
uppercase Q until you return to the root user prompt. If Q doesn't quit, you can 
also send the interrupt character (which, by default, you enter under A/UX by 
holding down CONTROL while typing c) to quit dp without making any changes. 
You can also enter a question mark (?) at the Command? prompt to see a list of 
available dp commands. 
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If A/UX doesn't boot to single-user mode 

If you get the Finder Desktop under the Macintosh OS or the Icon of a blinking 
question mark instead of the sash application, check the following and correct 
as necessary. 

a The disk containing A/UX must be powered on and properly cabled to the 
Macintosh II. (The disk icon for sash partition will be visible on the right 
side of the screen if the disk is properly connected.) 

□ If you want A/UX to start up automatically, the disk containing A/UX should be 
made the Startup Device. Use the Control Panel desk accessory to configure 
the disk sash partition to be the Startup Device. (This procedure is 
explained in detail in "Using the Control Panel" in Chapter 3 of your 
Macintosh II owner's guide.) 

□ If you want A/UX to start up automatically, sash should be made the startup 
application on the Startup Device. Use the mouse to move the pointer to the 
sash application and click once. Doing this highlights the sash icon. Then 
choose Set Startup from the Special menu. This selects sash as the startup 
application. 

a If you do not want A/UX to start up automatically, or if it was not previously 
configured to start up automatically, double-click the sash application. This 
starts the A/UX automatic boot procedure. 

If you receive an error message like 

Disk cOdOsO Error: Cannot select SCSI device 
generic disk cOdOsO Fatal Error: Logical block 
chroot failed 
sash# 

then sash is configured to boot off the wrong Hard Disk SC. From the sash 
screen, choose General from the Preferences menu, and change the first number 
in the RootDirectory box to be the SCSI ID number of the hard disk containing 
A/UX (as explained in Appendix B of the A/UX Installation Guide). 

a In response to the Command? prompt, enter the uppercase letter 

P 

to print to your screen information about all allocated partitions on the disk. The 
dp utility returns output similar to that shown next. 

Name: "Macintosh", Type: "Apple_HFS" 
Physical: 156353 @ 16, Logical: 156353 @ 
Status : 

valid alloc in_use boot 

read write 
No Block Zero Block 
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Particularly notice the number of physical blocks reported in the second line. 
The number 156353 is the approximate number of blocks you should find on a 
Hard Disk 80SC; you should find approximately 84277 physical blocks on a Hard 
Disk 40SC, and approximately 38965 physical blocks on a Hard Disk 20SC. 

□ Write down the number of physical blocks reported to you by dp. You will use 
this number as an argument to the mkf s command later when you make a UNIX 
file system on the disk. 

4. Use the dp utility to change the file type to a UNIX file system. 

□ The dp utility should again display its Command? prompt. Enter a lowercase c 
and the number as shown here: 

cO 

This command tells dp to change partition 0, which is the only one on the disk. 
You are now prompted for the data. partition map entry (DPME) field: 

DPME Field? 

□ Enter 

t 

to change the file system type. The dp utility then prompts whether to partition it 
as a default UNIX type: 

Default type? 

□ Answer yes to this prompt by entering the lowercase letter 

y 

You are again prompted for the DPME field: 
DPME Field? 

□ Enter 

b 

to establish the partition's block zero block (B2B). You are prompted to provide 
the cluster number for the BZB: 

Cluster # [0] : 

□ Enter the number 



for the cluster number. You must enter this number; pressing RETURN doesn't 
send as the default answer. You are now prompted to choose between three file 
system types: 

FS type (1=UNIX, 2=EFS, 3=SFS) [?] : 
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D Enter the number 

1 

to specify the file system type as UNIX. You are now prompted to decide whether 
or not to create the partition as a root file system, in which case it will be created 
on slice (specified as the number following the s in the /dev/dsk/cwdOsO 
device name). 

Root file system? 

In response to this prompt, you can answer y to create the file system on slice 0; 
you can answer n to create it as a us r file system on slice 2 (at the next prompt); 
or you can answer n to this prompt and the next prompt, in which case you must 
use the pname (1M) utility to name and associate the partition with a device 
node. (Refer to A/UX System Administrator's Reference for information about 
pname.) 

□ The simplest and easiest way to create and maintain the file system is to make it a 
root file system; to do so, respond to the Root file system? prompt with 
the lowercase letter 

y 

You are prompted to decide whether or not to create the partition as a us r file 
system, in which case it will be created on slice 2: 

Usr file system? 

□ Since you've already created the partition as a root file system on slice 0, enter 
n 

You are again prompted for the DPME field: 

DPME Field? 

□ Enter 

n 

to begin changing the partition's name. Now you're prompted for a name for the 
partition: 

Name [Macintosh] : 

□ Give the partition any useful name, such as 
A/UX_Partition 

Again you're prompted for the DPME field: 
DPME Field? 

□ Enter 

q 

to quit the file type configuration module of dp. Doing this returns you to the dp 
utility's Command? prompt: 

Command? 
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5. Examine the new attributes of the partition. 

Respond to the Command? prompt by entering the uppercase letter 

P 

You will see the changes made to the Hard Disk SC's partition. The following is a 
sample of the kind of output to expect. The number of physical and logical blocks 
reported in the second line of this output may differ, depending on the size of the 
Hard Disk SC you partitioned and on the number of available good blocks. 

DPM Index: 

Name: "A/UX Partition", Type: "Apple_UNIX_SVR2" 
Physical: 156353 @ 16, Logical: 156353 @ 
St at u s : 

valid alloc in_use boot 
read write 
Regular UNIX File System (1) 
Cluster: Type: RFS Inode: 1 
Made: [0] Wed Dec 31 16:00:00 1969 
Mount: [0] Wed Dec 31 16:00:00 1969 
Umount: [0] Wed Dec 31 16:00:00 1969 
No AltBlk map 

6. Write the changes to the partition and quit dp. 

In response to the Command? prompt that appears on your console, enter the 
lowercase letters 

wq 

to save your partition changes and quit the dp utility. The root user's command 
prompt should reappear on your console. 



Making and mounting an A/UX file system 

Now that you've initialized your external Hard Disk SC and partitioned it for A/UX, 
you're ready to make a file system on it and mount it onto your A/UX directory 
hierarchy. 

1 . Use mkfs to make a file system on the new Hard Disk SC. 

The mkfs utility constructs a file system on a block device such as a Hard Disk SC. 
The format of the mkfs command you will enter is 

mkfs /dev/dsk/cwdOsj number _of_blocks 
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The variables in this command for which you must supply values are as follows: 

D n, the SCSI ID number of the disk. This number is normally 5 for the first external 
Hard Disk SC, or 6 for the second. 

D y, the disk slice on which you created the A/UX partition. This number is if you 
created a root partition, or 2 if you created a usr partition. 

□ number _of_blocks, the number of physical blocks partitioned on the disk. You 
should have written this number down when you performed step 3 in 
"Partitioning a Hard Disk SC for an A/UX File System." 

Replace these variables with the appropriate values for your system, and enter them 
into the mkf s command. For example, if the SCSI ID number for the disk you are 
adding is 6, if you created a root partition at slice 0, and if the dp utility reported 
that your disk has 156353 physical blocks on it, you would enter the following 
command: 

mkfs /dev/dsk/c6d0s0 156353 

The following message appears: 

Mkfs : /dev/dsk/c6d0s0? 
(DEL if wrong) 

This gives you 10 seconds in which you can press the DELETE key and cancel the 
mkfs command. Don't press DELETE; within 10 seconds, mkfs begins 
constructing a file system on the partition of your external Hard Disk SC. When 
mkfs is finished, it reports the total number of logical blocks and inodes created on 
the disk and returns your command prompt. 

2. Run f sck on the new Hard Disk SC. 

To ensure the consistency of the file system you just made, run the f sck utility by 
entering the following command, but be sure to substitute the Hard Disk SC's SCSI 
ID number for n and to substitute the partition's slice number for y- 

fsck -y /dev/dsk/cndOsjy 

For example, if your new external Hard Disk SC has SCSI ID number 6 and the slice 
number for the partition is 0, enter the command 

fsck -y /dev/dsk/c6d0s0 

If there are any inconsistencies, fsck automatically repairs them for you. 
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3. Make a mount point for the new file system. 

You attach an A/UX file system to the rest of the directory hierarchy at a mount 
point. You can use any directory for a mount point, but any files in the directory 
will be obscured for the duration of the mount. For example, the empty directory 
/mnt was shipped on your A/UX distribution disk as a convenient mount point. 
However, you may want to reserve /mnt for temporary file systems; for example, 
you may wish to use /mnt for mounting file systems on removable 3.5-inch disks. 

The following instructions describe how to name a mount point that refers explicitly 
to the Hard Disk SC that contains the mounted file system. If you add more than one 
Hard Disk SC, this process provides a convenient way to identify the physical 
locations of your file systems. 

Replacing the SCSI ID number of the Hard Disk SC for n, enter the following 
command: 

mkdir /hdscn 

For example, if your new external Hard Disk SC has SCSI ID number 6, enter 

mkdir /hdsc6 

This directory is the mount point where you will attach the file system contained on 
your new Hard Disk SC. 

4. Mount the new file system. 

Replacing the SCSI ID number of the Hard Disk SC for n, and replacing the partition 
slice for y, enter the following command: 

mount -v /dev/dsk/c«dOs^ /hdscw 

The command returns a message informing you that the file system on your 
additional Hard Disk SC is now mounted as the /hdscw directory. 

For example, if your new external Hard Disk SC has SCSI ID 6 and the slice number 
for the partition is 0, enter 

mount -v /dev/dsk/c6d0s0 /hdsc6 

5. Create a lost+f ound directory for the new file system. 

□ Change directory to the new file system's mount point. Replacing the SCSI ID 
number of the Hard Disk SC for n, enter the command 

cd /hdscw 

For example, if your new external Hard Disk SC has SCSI ID 6, enter 

cd /hdsc6 
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□ Type the following command to create a lost+f ound directory on the new file 
system: 

mklost+f ound 

This command reports its progress as it creates a lost+f ound directory in the 
top directory of the new file system, and creates and removes empty files to make 
slots available for future use. 

In the future, when you run f sck on this file system after a system crash, and 
there are files that have become unconnected in its directory structure, f sck will 
place the files in this lost+f ound directory. Files connected to lost+f ound 
are named by their inode number instead of their original filenames. You can 
use the Is -1 command to determine who the files belong to, and then tell the 
owners to copy the files back to their directories under their original filenames. 

6. Test the file system. 

To verify that your new file system is accessible, try writing to it and reading from it 
with the following commands. (Substitute the SCSI ID number of your new Hard Disk 
SC for w.) 

cp /etc/passwd /hdscrz/mount .test 
cat /hdsctt/mount .test 

Your system's password file should scroll across your screen. Enter the command 

rm /hdscw/mount .test 

to remove the test file. 

If the password file did not appear, reenter the commands in this step and make sure 
you type them correctly. If the password file still does not appear, start over at step 1 of 
this section and repeat all of the steps. 

7. Put the file system entry in /etc/ f stab. 

Begin by making a backup copy of /etc/ f stab. 

cp /etc/fstab /etc/f stab. old 

When changing an important system file like this, it is always a good idea to back it up 
so that if something goes wrong, you can always copy the backup to its original name 
and restore your system to its previous state. 
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To add a new entry to /etc/ f stab, type 

cat » /etc/fstab 

and press RETURN. The cursor will move to a new line, but you will not see a prompt. 
Replacing n with the SCSI ID number of the additional Hard Disk SC, and replacing y 
with the partition slice, type the following line (but don't press RETURN yet): 

/dev/dsk/cwdOsj> /hdsctt 5.2 rw 1 2 

For example, if your new external Hard Disk SC has SCSI ID 6 and the partition is 
located at slice 0, type 

/dev/dsk/c6d0s0 /hdsc6 5.2 rw 1 2 

Before you press RETURN, make sure you have entered the line correctly. If you 
mistyped, press DELETE to back over and erase previous characters, and then retype 
the correct ones. 

After you've double-checked that you typed the correct information, press RETURN. 
The cursor moves to a new line, but you will not see a prompt. 

Hold down CONTROL and type d. 

The command prompt will reappear. The line you typed earlier is now included in the 
file /etc/fstab, and the file system on your additional Hard Disk SC will be 
mounted automatically whenever you boot A/UX to multiuser mode. 

The next time you reboot A/UX to multiuser mode or bring it down to single-user 
mode and then back to multiuser mode, enter the command 

mount 

This command, with no options or arguments, reports all of the mounted file systems. 
The device name for your new Hard Disk SC and its mount point should appear in this 
brief report. 

♦ Note: If the mount command does not return a listing for your new Hard Disk SC, 
then its entry in /etc/fstab is incorrect. You may have already noticed that 
something is amiss. (For example, f sck may have returned a SCSI error message 
when checking the file system.) Return /etc/fstab to its previous state with the 
command 

cp /etc/fstab. old /etc/fstab 

and then repeat all of step 7. 
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Addendum: How A/UX boots from hard disks 

A/UX has been designed to be booted off of any SCSI disk, from SCSI ID through 
SCSI ID 6. The A/UX kernel accepts boot device information from sash. This design 
is unlike many other UNIX kernels, which frequently have the boot device "hardwired" 
into the kernel and require use of adb or similar programs to patch in boot device 
changes. 

The A/UX kernel requires two pieces of information about the disk that it will be 
running off of: the root file system and the swap area. The A/UX kernel does not know 
about disks in general. Rather, it knows that it can call one of several block device 
drivers (by using the major number to select one of the block device drivers), and that 
it can pass to that block device driver a parameter (the minor number) indicating to 
the block device driver just where to go. 

The block device driver (in the case of the A/UX initial release, the SCSI disk driver) 
uses the minor number to select the SCSI ID number and a slice — that is, a 
partition — of the disk. The minor number is meaningless to the A/UX kernel; it merely 
passes it along to the block device driver. 

The steps of the algorithm that A/UX uses for booting are as follows: 

1 . The sash application (a Macintosh OS application) is launched. It finds the A/UX 
kernel (from one of several possible places) and loads it into main memory. It 
leaves in main memory a set of major and minor numbers for A/UX to use for the 
root file system and swap area. You can change these major and minor numbers 
by pulling down the Preferences menu and choosing General from sash. The 
General dialog box shown in Figure 4-20 appears. 
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Figure 4-20 

The General dialog box under sash 
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The RootDirectory box (see Figure 4-21) is used to change the information that is 
passed to the A/UX kernel. In the initial release of A/UX, only the first two numbers 
of the set (0,0,0) are used. The last number is currently ignored. 



RootDirectory: 



10,0,01/ 



n a 



t_ 



Slice number (ignored in current release) 
SCSI sub-drive number 
SCSI ID number 



Figure 4-21 

The RootDirectory box 

2 . When the A/UX kernel begins executing, it examines the internal variables 
rootdev, swapdev, and pipedev. These variables each contain a major and a 
minor number, and each variable identifies (to the block device driver) the root 
file system, the swap area, and the pipe file system. (The pipe file system is almost 
always the same as the root file system.) 

If any of these variables contain an "illegal" value (Oxff), then A/UX uses the values 
left by sash in a specified area of main memory. As stated previously, you can 
change these values by selecting General from the Preferences menu of sash. 

The A/UX kernel as initially configured has the variables rootdev, swapdev, and 
pipedev, each set to (0xff,0xff). You can use the kconf ig(l) program to set these 
variables to a predetermined value; in which case, you can have "hardwired" in the 
root file system or swap areas. 

3 . The A/UX kernel then calls the device driver, asking for blocks to be read and 
written. The minor number is passed along to the block device driver, which breaks 
it down into the SCSI ID number and the slice number. The first time the block 
device driver is requested to read or write on a slice, it must build the slice 
information table entry. 

There are 32 active slices possible for a disk drive. By convention, slice is always 
the root file system, slice 1 is always the swap area, slice 2 is a us r file system, and 
slice 31 is always the entire disk. 

The first read or write for slice or slice 1 causes the block device driver to see if the 
disk has a partition table on it. If it does, the partition table is scanned to look for 
entries identifying the root file system and swap area. If found, the partition entry 
information is loaded into the slice information table entry. 

4 . If the disk has no partition entry table, and when the block device driver sees a read 
or write request the first time for either slice or slice 1, slice and slice 1 are 
automatically configured to a set number of blocks based upon the total number of 
blocks on the disk. 

5 . If no partition entry is found, then the disk is not recognizable to A/UX. You will 
probably receive a SCSI error message when trying to access the disk. 
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Section 5 



A/UX Toolbox 



The A/UX Toolbox is a library that enables a program running under A/UX to call the 
User Interface Toolbox routines built into the Macintosh II ROMs. The A/UX Toolbox 
lets you write A/UX programs that take advantage of the standard Macintosh user 
interface tools, such as the Window Manager, Menu Manager, and Dialog Manager. 
This library is described in A/UX Toolbox: Macintosh ROM Interface. 

The A/UX Toolbox also supports the basic elements of the native Macintosh 
Operating System (OS). 



Limitations at the first release (1.0) 

At first release, the A/UX Toolbox is not feature-complete. The following limitations 
exist: 

□ No support for color displays. The color QuickDraw calls are available, but they 
function as if the user had the display in 1-bit-per-pixel mode. 

□ No printing. Calls to PrOpen () will fail. 

□ No shared libraries. All Toolbox applications will have to be relinked for the next 
release of the Toolbox. 

□ No layering. Only one Toolbox application can be run at a time. 



Resource format and file changes 

Since A/UX Toolbox: Macintosh ROM Interface was published, the format and file- 
naming conventions of resource files have been changed. Resource files (with the 
filename extension . res) described in the manual appear in the release either as an 
AppleSingle file (with the filename prefix %) or as part of an AppleDouble file. See the 
following description of AppleSingle and AppleDouble file formats and the manual 
page for rcnvt(l) in AAJX Command Reference. 



Formats for Apple files in foreign file systems 

♦ Note: This section presents proposed file formats. The information was originally 
presented in a draft proposal dated October 23, 1987. This information is subject to 
change. 

Apple Computer, Inc., is proposing two standards for representing files on foreign file 
systems, with the goal of preserving all attributes of the file's home file system on other 
file systems that do not support the same attributes. 

Because of the varying needs of different file systems, a single format seems to be 
inadequate to cover all cases. However, two closely related formats can serve most 
needs. Although the primary impetus for developing these formats is storing 
Macintosh files on file systems that do not support the notion of two forks, the 
proposed formats are general enough that you can use them to represent a file from 
any file system on any other file system. 

The two formats are called AppleSingle and AppleDouble. 

In AppleSingle format, all contents and attributes of a file are kept in a single file on the 
foreign file system. For example, both forks of a Macintosh file, the Finder 
information, any associated icons, and so on are arranged in a single file with a simple 
structure. This format is intended to be used primarily as a storage format — that is, for 
cases in which the Macintosh file must be stored on a foreign file system and later 
reconstructed into a true Macintosh file. 

AppleDouble format is more appropriate for applications in which the users of the 
foreign file system might want to modify the contents of the file. Since most Macintosh 
applications keep the file data in the data fork, AppleDouble format saves the contents 
of the data fork in one file. AppleDouble format keeps all other file attributes in a 
separate file. 

Specifically, Apple's proposal does not rule out the possibility of building 
applications that can access and modify AppleSingle-format files. Nor does it 
preclude using AppleDouble format for simple storage of Macintosh files. This 
proposal merely presents them as alternatives. 
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The only assumption this proposal makes is that each file system on which these file 
formats will be supported allows the creation of a simple file: an uninterpreted stream 
of bytes. 

AppleSingle and AppleDouble formats are not directly related to the AppleTalk® 
Filing Protocol (AFP). While one of their possible uses is as the storage format for 
non-Macintosh-based AFP servers, it was not the primary motivation behind their 
development. 

If you are building an AFP server (or an NFS or other server that supports Macintosh 
computers), then you may wish to use one of the formats as your internal file storage 
format. However, the choice is yours. It does not matter what format is used within 
your application as long as, externally, the files appear as they are supposed to. 

There are at least two basic reasons for using either the AppleSingle format or the 
AppleDouble format: 

□ As a standard for transferring files between host computers (interhost transfers). 
For example, Macintosh files could be easily and completely shipped among 
heterogeneous systems if they all understand one of these common formats. You 
can use any existing electronic mail system or file transfer utility without 
modification. 

□ As a standard for operating on foreign files within a single host (intrahost transfers). 
In the near future, for example, A/UX applications may build and manipulate 
Macintosh resource forks (perhaps in a cross-development system). If a set of users 
of a host computer wishes to write Macintosh-aware applications, the users need to 
agree on a common storage format, such as the AppleSingle or the AppleDouble 
format. 

The following discussion uses these terms: 

□ home file system: the file system for which the file's contents were created. For 
example, an A/UX application could create an AppleSingle file that comprises a 
resource fork and a data fork and that contains a MacWrite-formatted document. 
The home file system for such a file is the Macintosh file system, because the file is 
intended to be compatible with a Macintosh application. In most cases, where a file 
is created and used on the same file system, the home file system is that system. 

D foreign file system: the other file system that will store or process the file. An 
AppleSingle or AppleDouble file is usually a representation of a file's contents on 
the foreign file system. 
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AppleSingle format 

An AppleSingle file contains a header followed by data. The header consists of several 
fixed fields and a list of entry descriptors, with each descriptor pointing to an entry. 
Apple defines these standard entries: 

□ Data Fork 

□ Resource Fork 

□ Real Name (name in the home file system) 

□ Comment 

□ Icon 

□ File Info 

Each entry is optional and may or may not appear in the file. 
An AppleSingle-formatted file follows this structure: 



Header 


Magic number 


4 bytes 




Version number 


4 bytes 




Home file system 


16 bytes ASCII encoded 




Number of entries 


2 bytes 


For each entry 


Entry ID 


4 bytes 




Offset 


4 bytes 




Length 


4 bytes 



The magic number field is modeled after the magic number feature in UNIX. The field 
is intended to be used in whatever way the foreign file system distinguishes a file as 
AppleSingle format. The magic number for AppleSingle format is $00051600 or 
0x00051600. 

The version number field denotes the version of AppleSingle format in case the format 
evolves (more fields may be added to the header). The version described here is 
version $00010000 or 0x00010000. 

The home file system is a fixed-length, 16-byte ASCII string that is not preceded by a 
length byte but is possibly padded with blanks. 

The home file system header has one of these Apple-defined values: 

or $4D616369 $6E746F73 $68202020. 

or $50726F44 $4F532020 $20202020. 

or $4D532D44 $4F532020 $20202020. 

or $556E6978 $20202020 $20202020. 

or $56415820 $564D5320 $20202020. 

Apple welcomes suggestions for other file systems that should be included in this list. 
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Macintosh 


'Macintosh ' 


ProDOS 


'ProDOS' 


MS-DOS 


■MS-DOS' 


UNIX 


'Unix' 


VAX/VMS 


'VAX VMS' 



Data Fork 


1 


Resource Fork 


2 


Real Name 


3 


Comment 


4 


Icon, B&W 


5 


Icon, Color 


6 


File Info 


7 


Finder Info 


9 



The number of entries field tells how many different entries are included in the file. 
The field contains an unsigned 16-bit number, and may be zero. If the number is 
nonzero, then that number of entry descriptors immediately follows this field. 

For each entry, the entry descriptor indicates what the entry is, where the entry is 
located in the file, and how big the entry is. 

Apple has defined a set of Entry IDs and corresponding values, as follows: 

Standard Macintosh data fork 
Standard Macintosh resource fork 
The file's name in the home file system 
Standard Macintosh comment 
Standard Macintosh black-and-white icon 
Standard Macintosh color icon 
File information, such as attributes 
Standard Macintosh Finder Info 

Apple reserves the range of Entry IDs from to $7FFFFFFF for future use. The rest of the 
range is available for other systems to define their own entries. Apple will not arbitrate 
the use of the rest of the range. 

Icon entries will probably not appear in most files since they are typically stored as a 
bundle in the application file's resource fork. 

The File Info entry is different for each home file system. For Macintosh HFS, the entry 
is 16 bytes long and consists of three long integer dates (creation date, last 
modification date, and last backup date) and a long integer containing 32 Boolean 
flags. Using the bit-numbering scheme where bit is the least-significant bit and 31 is 
the most-significant bit, bit of the Macintosh Finder Info entry is the Locked bit; bit 1 
is the Protected bit. Formats for other file systems (MS-DOS, UNIX, ProDOS®, and 
others) are still to be defined. 

The actual data representing the entry must be in a single contiguous block. The block 
is pointed to by the offset field, which is an unsigned 32-bit number indicating the byte 
offset from the start of the file to the start of the entry. The entry length is also an 
unsigned 32-bit number representing the length in bytes. The length may be zero. 

After some number of entry descriptors, the actual entry data appears. The entries 
could appear in any order, but because the data fork is the entry that is most 
commonly extended, Apple strongly recommends that the data fork entry always be 
kept last in the file to facilitate its extension. 

Apple also recommends that those entries that most often need to be read, such as 
Finder Info, Real Name, and Dates, be kept as close as possible to the header to 
maximize the probability that a read of the first one or two blocks of the file will 
retrieve these entries. 
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It is possible to have holes (unused space between entries) in the file. To find where the 
holes are, you must take the list of entry descriptors and sort them into increasing 
offset order. If the offset field of an entry is greater than the offset plus the length of the 
previous entry, then a hole exists between the entries. You can make use of such holes; 
for example, if a file's comment is 10 bytes long, you could create a hole of 190 bytes 
after the comment field to allow easily for the comment to expand to its maximum 
length of 200 bytes. Because an AppleSingle file may contain holes, you must find 
each entry by getting its offset from its entry descriptor, and not by assuming that it 
begins after the previous entry. 

Byte ordering in the file header fields will follow 68000 and 68020 conventions. 



AppleDouble format 

AppleDouble format is the same as AppleSingle format, except that the data fork is 
kept in a separate foreign file. The file containing the data fork is called the 
AppleDouble data file, and the other file is called the AppleDouble header file. 

The AppleDouble data file consists of only the standard Macintosh data fork, with no 
extra header at all. The AppleDouble header file has exactly the same format as the 
AppleSingle file, except that it does not contain a data fork entry. The magic number 
of an AppleDouble header file differs from that of an AppleSingle file so an 
application can tell whether or not it needs to look elsewhere for the data fork. The 
magic number for AppleDouble format is $00051607 or 0x00051607. 

The entries in the header file could appear in any order, but since the resource fork in 
this case is the entry that is most commonly extended, Apple strongly recommends 
that the resource fork entry always be kept last in the file. The data fork is easily 
extended, because it resides by itself in the AppleDouble data file. 

If it is possible on the foreign file system, you could create a new type of entry that 
pointed to the AppleDouble data file to make the file easy to find. 



Filename conventions 

AppleSingle format specifically does not include an algorithm for generating the 
AppleSingle filename from the file's real name. The foreign file systems of interest 
differ quite a bit in filename syntax, and the file's real name can be kept as an entry 
within the AppleSingle file. 

The same is generally true for AppleDouble data filenames. However, Apple is 
proposing a standard for deriving the AppleDouble data file and AppleDouble header 
filenames from the file's real name. Because filename syntax differs in the various file 
systems, the proposed standard varies according to file system. 
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UNIX 

To generate the AppleDouble data filename, use character substitution to replace any- 
illegal characters with an underscore (_) and, if necessary, truncate the filename to 14 
characters. 

To generate the AppleDouble header filename, prefix a single percent sign (%) to the 
AppleDouble data filename. If necessary, truncate the last character to keep the 
filename within the legal length range. 



ProDOS 

To generate the AppleDouble data filename, use character substitution or deletion to 
remove illegal characters, and use truncation if necessary to reduce the length of the 
name to two characters less than the maximum filename length. 

To generate the AppleDouble header filename, add the two characters uppercase-R 
and period (R . ) as a prefix to the AppleDouble data filename. 



MS-DOS 

To generate the AppleDouble data filename, use character substitution or deletion to 
remove illegal characters, and use truncation if necessary to reduce the length of the 
name to eight characters. Then add the MS-DOS extension that is most appropriate to 
the file (for example, '.TXT' for a pure text file). 

To generate the AppleDouble header filename, add the extension '.ADF (for 
AppleDouble file) to the eight-character filename. 

AppleDouble name derivations will be defined for all other file systems of interest. 
These name derivations will allow applications running on the foreign file system (and 
human users as well) to see easily which files are AppleDouble pairs. Users who know 
the derivation could rename or move the files in order to preserve the connection 
between the two. However, there is no guaranteed way to prevent one file of the pair 
from being inconsistently renamed, moved, or deleted. 
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Section 6 



A/UX Kernel Messages 



This section describes two types of messages generated by the A/UX kernel: 

□ panic messages 

□ warning messages 



A/UX kernel panic messages 

An A/UX kernel panic can result from any one of four basic causes: 

□ Kernel resources. A kernel resource panic, such as kmem_alloc (not enough free 
memory for kernel alloc), is caused when some preset resource limit is exceeded. 
Most often, these limits are imposed either by the physical hardware or by kernel 
parameters set at boot time. You can overcome some hardware limitations by 
expanding your system (physically adding more memory, for example). You can 
also modify some kernel parameters (see kconfig(lM) in A/UX System 
Administrator's Reference and the section "Changing Kernel Parameters" in these 
release notes). 

□ Catastrophic failure. A catastrophic failure panic is normally caused by a hardware 
failure (such as memory errors), which can interfere with normal execution of 
instructions or can destroy kernel data. The panic thus provides software validity 
checks on the kernel environment. In the case of such an error, the system is halted 
before additional damage can occur or can be transferred to the root file system. 

As with any major system error, large data loss is possible. The best protection is 
frequent backups. While major malfunctions are rare, spending a few minutes a day 
can save months of work in case of catastrophic failure. You should never see a 
catastrophic kernel failure. If you do, contact your Apple representative. 



6-1 



□ Introduced error. Errors are ordinarily introduced to the kernel only during 
program development, usually by the addition of a new device driver. The panic 
supplies useful diagnostic feedback to the programmer. An everyday user should 
never see these panic messages. 

Sometimes, though, a coding error in the kernel shows up only under unusual 
circumstances. These are the "bugs" in the kernel. If you see a kernel panic caused 
by an introduced error during normal operation, report it to your Apple 
representative. 

□ Corrupt file system. In some cases, it is possible to destroy portions of the root file 
system through the use of broken hardware, bad drivers, or even unreasonable raw 
device IO requests. (The best protection against this kind of damage is to run 

f sck(lM) when booting the system.) If one of these panics occurs, run f sck and 
repair the file system as necessary. Damage to the file system must be fairly severe 
to produce these panics. Be prepared to resort to the re-creation of the file system 
and complete restoration from your backups (see A/UX Local System 
Administration and the manual page for f sck(lM) in A/UX System 
Administrator's Reference). 

Table 6-1 lists all of the possible kernel panic messages, describes the most likely cause 
of each, and offers suggestions for dealing with those problems that you can address. 



Table 6-1 

A/UX kernel panic messages 



Message 



Type 



Comments 



"CPU can't page fault 
properly" 

"Error in standalone 
driver mkbad 
implementation" 

"Error in standalone 
driver onestate() 
implementation" 

"SCSI manager software 
error in state table" 

"accept" 
"ae6int" 



Catastrophic failure Check hardware configuration. 



Catastrophic failure 



Catastrophic failure 

Catastrophic failure 

Catastrophic failure 
Catastrophic failure 



Unexpected interrupt from an 
"empty" NuBus slot. Look for the 
problem on NuBus. 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



'alloc:bad size" 



'allocbuf" 



"bad clist count" 

"bad major number in 
gdrestart" 

"blkdev" 

"bread" 

"bread: size 0" 

"breada" 

"breadrabp" 

"brealloc" 

"bwrite" 

"call of function at 
location" 



"cannot allocate 
buffer cache" 



"cannot allocate 
buffer headers" 



"cannot allocate 
character buffers" 

"cannot allocate page 
hash table" 

"clget:null client" 

"closef " 

"devtovp badop" 



Catastrophic failure 



Kernel resources 

Catastrophic failure 
Introduced error 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Introduced error 



Kernel resources 
Kernel resources 
Kernel resources 

Kernel resources 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 



Corrupt file system. Requested file 
system block not standard size. Check 
drive; run f sck(lM) to rebuild as 
necessary. 

Argument size greater than available 
buffer size. Increase variable 
SBUFSIZE with kconf ig(lM). 



Check hard disk and cables. 

Check hard disk and cables. 
Check hard disk and cables. 



Printed message routine when 
a pointer to a function is not 
initialized properly; for example, 
(*func) () == 0. 

Add physical memory and increase 
variable NCLIST with kconf ig(lM) or 
reduce memory use. 

Add physical memory and increase 
variable NBUF with kconf ig(lM) or 
reduce memory use. 

Add physical memory and increase 
variable NCLIST or NBUF with 
kconf ig(lM) or reduce memory use. 

Add physical memory or reduce 
memory use. 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



"direnter : target 
directory link count" 

"dirmakeinode : no 
attributes" 

"dirprepareentry : 
invalid slot status" 

"dirprepareentry : new 
block" 

"dnlc_pruge : zero vp" 

"dup biodone" 

"error in standalone 
driver implementation" 

"findreg — no match" 

"free:bad size" 



"freeproc — cannot 
find child on chain" 

"fstat" 



"getfreehdr" 

"getma jor" 
"getmptbad magic" 
"getpages — pbremove" 
"10 error in swap" 
"icmp len" 
"icmp_error" 
"igetrbad dev" 
"iget:bad fs" 



Corrupt file system 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 

Catastrophic failure 
Corrupt file system 

Catastrophic failure 

Corrupt file system 
or also 
Catastrophic failure 

Kernel resources 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 



Corrupted file system. Run f sck(lM) 
as necessary to correct. 



Check drive being used at time of 
error. 



Requested file system block is not 
standard. Check drive, run f sck(lM) 
as necessary to correct. 



Unknown file type in status read. 
May also be a catastrophic failure. 
Check drive. Run f sck(lM) as 
necessary to correct. 

Unable to find a free block header. 
Increase the variable NPBUF with 
kconfig(lM). 



Check hard disk and cables. 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



"in_control" 

"interrupt stack 
overflow" 



"ip_init" 

"iput" 

"irele" 

"itruncl" 

"itrunc2" 

"iunlock" 

"kernel memory 
management error' 

"kmem alloc" 



"kmem_f ree" 

"kmem_free: block 
already free" 

"kmem_free block 
already free 
as neighbor" 

"kmem_f ree_intr" 

"m_clalloc" 

"m_clalloc MPG_SPACE' 

"m_copy" 

"m_cpytoc" 

"m more" 



Catastrophic failure 
Introduced error 



Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 

Kernel resources 



Catastrophic failure 
Catastrophic failure 

Catastrophic failure 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 



Interrupt stack is located in the UDOT 
area. Even though you can increase 
the size of the UDOT (and stack), this 
is not recommended. Instead, reduce 
use of the stack in the driver interrupt 
service routine being worked on. 



Generic 68000 bus error message. 
Kernel bus error has occurred. Check 

all hardware. 

Not enough free memory for kernel 
allocation request; more kernel activity 
than allowed by current memory size. 
Add physical memory and adjust the 
variable MAXCORE with kconf ig(lM). 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



"main.c — copyout of 
icode failed" 

"main.c — iicode 
growreg failure" 

"mbinit" 

"mcldup" 

"mclput" 

"missing phys () " 

"mminit" 

"nf s_badop" 

"no procs" 

"pinsert dup" 

"piusrreq" 

"psig" 

"psig action" 

"ptcwrite" 

"raw_usrreq" 

"realvt op : invalid 
search depth" 

"region count list 
overflow" 

"remrq" 

"revarprno mbufs" 

"rfs_lookup" 

"rootf smount : cannot 
mount root" 

"rootmount: cannot 
find root vnode" 

"rtfree" 



Kernel resources 
Kernel resources 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 

Catastrophic failure 

Catastrophic failure 
Kernel resources 

Catastrophic failure 
Catastrophic failure 

Catastrophic failure 
Catastrophic failure 



Add physical memory or reduce 
memory use. 

Add physical memory or reduce 
memory use. 



Increase the variable NMBUFS with 
kconfig(lM). 



Check hard disk and cables. 



Check physical memory. 
Check hard disk and controller. 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



"rwip" 

"rwvp:zero size" 
"sbappendaddr" 
"sbdrop" 

"sbflush" 
"sbflush 2" 
"soaccept:NOFDREF" 
"soclose :NOFDREF" 

"socreceive flush 
PR_ATOMIC" 

"socreceive get 

MT_RIGHTS" 

"socreceive no 
packets" 

"sofree dq" 

"software error in 
SCSI finish reset" 

"software error 
unknown command 
in mkbad() " 

"sois connected" 

"soreceive no aname" 

"soreceive no rights 
or address" 

"sorecieve no mbufs" 

"sosend" 

"sptalloc — ptmemall 
failed" 

"sptfill — ptmemall 
failed" 



Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 
Catastrophic failure 

Catastrophic failure 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 

Kernel resources 

Catastrophic failure 
Catastrophic failure 

Catastrophic failure 



Increase the value of the variable 
NMBUFS with kconf ig(lJVD. 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



"sptseggrow: hard limit 
exceeded" 

"startup — swapadd 
failed" 

"svf s_badop" 

"svf s_inactive" 

"svf s_ioctl" 

"svf s_readdir" 

"svf s_select" 

"svf s_statf s" 

"syscallO" 

"syscalll" 

"tcp_output" 

"tcp_output REXMT" 

"tcp_pulloutofband" 

"tcp_usrreq" 

"timeout table 
overflow" 

"too many softcalls" 

"udp_usrreq" 

"uicp 3" 

"uiomove" 

"uipc 1" 
"uipc 2" 
"uipc 4" 

"unexpected kernel 

trap" 



Introduced error 

Catastrophic failure 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Corrupt file system 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Introduced error 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 



Too many spt alloc requests; reduce 
them. 

Swap device failed. Check hard disk 
and cables. 



Possible bad file system. Check drive 
for valid file system; run f sck(lM). 



Bad iovector passed to uiomove. 
Recheck code. 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



"unimplimented 
command in scsicmd" 

"uninitialized drive 
in gdaltinit" 

"unknown command in 
gdcmd" 

"unknown input in 
choosetask" 

"unknown input to 
scsi task" 

"unknown partition 
state in gdpartinit" 

"unknown state in 
gdinit_ret" 

"unknown state in 
gdstart" 

"unknown state in 
sdreturn" 

"unknown task state in 
drive init" 

"unknown task state 
in gdpartinit" 

"unp_connect 2 " 

"unp_dis connect" 

"unp_externalize" 

"unreconized state 
in gdaltinit" 

"ureadc" 

"uwritec" 

"vattr_to_nattr" 

"vfault — bad dbd_type" 

"vfs remove" 



Catastrophic failure 

Introduced error 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 

Introduced error 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Introduced error 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
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Table 6-1 (continued) 
A/UX kernel panic messages 



Message 



Type 



Comments 



"vf s_remove: 
unmounting root" 

"vfs_unlock" 

"viaclrius called from 
non-interrupt" 

"video interrupt" 

"vn_rel" 

"vno_lock" 

" vno_unlock : EXLOCK" 

"vno_unlock : SHLOCK" 

"wakeup p_stat" 

"xalloc — bad magic" 



Catastrophic failure 

Catastrophic failure 
Catastrophic failure 

Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 
Catastrophic failure 



A/UX kernel warning messages 

An A/UX kernel warning message may be generated by several places in the kernel, 
including the I/O device drivers and Memory Manager. 

The kernel warning messages listed here are not part of a kernel panic, and can 
provide information or a warning to the user. 

Kernel warning messages are classified according to the following types. 

□ Kernel status. These messages are usually printed at startup time and provide 
information on the currently running kernel, such as the kernel version or its 
configuration. Even though these messages are useful, you can generally ignore 
them. 

□ Fatal error. A serious kernel error has occurred; a kernel panic message is likely to 
follow. 

□ Kernel error. A kernel error has occurred. While additional errors may follow, this 
error was not fatal to the kernel. A user process may have been killed as a result. 

□ I/O status. A device driver has reported on some device status. A user may be 
interested in this information because it normally gives such information as device 
number and block size. 
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□ I/O error. A device driver has reported an error condition. Normally, these errors 
are fatal only to the process making the current request, which may be a request to 
put 10 MB on a 1-MB floppy disk. However, failure of the root file system disk can 
bring everything to a dead stop. Look for a kernel panic to follow errors on the root 
file system disk. 

□ I/O extended. Some device drivers have additional error messages that are more 
verbose then the normal IO error messages. These "extended" error messages are 
used primarily for debugging and are turned on by setting some variable in the 
driver. The user will not normally see these or need to use them. 



Table 6-2 

A/UX kernel warning messages 



Message 



Type 



Comments 



"%s - swpuse count 
overflow" 



"%s on bad dev %o(8) 



"%s: Setuid execution not 
allowed" 



", giving up" 



", still trying" 



"A/UX kernel created %s" 

"Can't allocate message 
buffer 



Kernel error Number of processes sharing a page 

of swap space has exceeded the 
capacity of the reference counter 
(currently 256). This error is very 
unlikely in a demand paged system, 
such as A/UX. 

I/O error Generic kernel driver error message. 

Currently not used by any A/UX 
device drivers. 

Kernel status The setuid (set user ID) function is 
not allowed on this NFS file system. 
This is an optional security feature 
that may be set according to the 
exported file system. 

I/O error This message appears after the "NFS 

server %s not responding" 
message to inform the user that an 
NFS connection has been given up. 

I/O status This message appears after the "NFS 

server %s not responding" 
message to inform the user that an 
NFS connection is still being 
attempted. 

Kernel status Kernel status message printed at 
system startup or reset. 

Kernel error Ran out of memory trying to initialize 

message queues. Reduce kernel 
memory usage with kconf ig(lM). 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"Changing free page high 
water mark from %d to %d" 



"Changing free page low 
water mark from %d to %d' 



"DANGER: Out of swap 
space. Needed %d pages" 



"DANGER: mfre map 
overflow %x: lost %d 
items at %d" 

"MC68881 Floating Point 
Coprocessor ID %d" 



'NFS %s failed for server 
is: %s" 



"NFS server %s not 
responding" 



'NFS server %s ok" 



"NFS write error %d on 
host %s fs %o file %d" 



Kernel status Kernel variable GETSPGHI has been 
reset; use kconf ig(lM) to reduce it. 
Unless you have a very good idea of 
what you are doing, you should not 
change this variable from its standard 
value. 

Kernel status Kernel variable GETSPGLOW has been 
reset; use kconf ig(lM) to increase it. 
Unless you have a very good idea of 
what you are doing, you should not 
change this variable from its standard 
value. 

Kernel error You should never see this message. 

If it does appear, treat it the same as 

"WARNING: Swap space running 
out. Needed %d pages" 

Kernel error Kernel structure has run out of 

memory. Increase variable NSPTMAP 
with kconf ig(lM). 

Kernel status Indicates that the floating-point 
processor is present (during boot 
time). 

I/O error Unable to make connection with 

remote server. Check remote 
system; it may be down, or may not 
have NFS daemons running. 

I/O status NFS remote server is not 

responding. Check the remote 
server; it may be down or may not 
have NFS daemons active. Also 
check hardware. 

I/O error Connection with NFS remote server 

remade. 

I/O error An error occurred during a write to 

the NFS remote host system. Check 
the remote machine, or contact the 
system administrator for the remote 
machine. 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"NFS write error: on host 
%s remote file system 
full" 

"Region table overflow" 



"Streams space not 
available" 



"System Buffers are more 
than 90% of remaining 
memory. UNIX kernel may be 
unstable — may need to 
adjust NBUFS with kconfig" 

"Unsupported block size 
of %d bytes" 



"WARNING: Swap space 
running out . 
Needed %d pages" 



"Warning: No Video 
Board Found" 



I/O error Remove files as needed to make 

space or contact host's system 
administrator. 

Kernel error Increase the size of the variable 

NREGION with kconfig(lM) or add 
physical memory to the system. 

Fatal error There is not enough memory to set 

up and run streams. Normally, no 
other error messages will follow 
because the kernel will be unable to 
continue to print to the console. Add 
physical memory to the system or 
reduce kernel memory use with 
kconfig(lM). 

Kernel status Kernel buffers are defined to be so 
large with kconf ig(lM) that they 
take up more than 90% of memory. 
Increase physical memory or reduce 
buffer sizes with kconfig(lM). 

I/O error The physical block size of a disk is 

not supported by A/UX. Reformat the 
device or find another device that can 
be supported. This error should not 
occur with standard Apple hardware. 

Kernel error Tried to get more swap space when 

needed, but was unable to remove 
unused sticky program from swap. 
Processes may die if they try to 
grow. Increase swap space by 
reconfiguring the hard disk, reduce 
the number of sticky programs, or 
reduce the size or number of in-core 
processes. 

Fatal error This message suggests that the 

video board is missing or broken. 
This message will appear at boot time 
and only through the first serial 
(/dev/ttyO) port. 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



'ae%d spurious interrupt" 



"ae%d transmitter frozen 
— resetting" 



"ae%d: ethernet address not 
found" 

"ae%d: init failed 



"ae%d: can't handle af%d" 



"ae6_intr: Receive 
overflow warning" 



"ae6int: interrupt from 
slot %d" 



"ae6int: Rev overflow, 
lost %d packets" 



"authkern_marshal : 
xdr authkern failed" 



"bad auth_len gid 
%d str %d auth %d" 



'bad block %d, ino %d" 



I/O error The EtherTalk card generated an 

interrupt, but its interrupt status 
register is 0. 

I/O error The EtherTalk card did not receive 

a transmit complete interrupt within 2 
minutes after transmitting a packet. 

I/O error The EtherTalk card could not read its 

address from slot ROM. 

I/O error The EtherTalk card did not respond 

to a stop command by asserting RST 
in its interrupt status register. 

I/O error The interface was handed a message 

with addresses formatted in an 
unsuitable address family. The packet 
was dropped. 

I/O error An overflow condition was noted by 

the EtherTalk card on incoming 
packets. 

Fatal error The EtherTalk card received an 

interrupt from a slot number that is 
less than 9 or greater than 14 Qegal 
range for slot interrupts is between 9 
and 14). 

I/O error The EtherTalk card missed the stated 

number of packets because no buffer 
space was available. 

Kernel status An xdrON) routine failed while 

attempting to deserialize user area 
credentials. 

Kernel status An xdr(3N) routine failed while 

attempting to deserialize user area 
credentials. The numbers given 
should be the xdr length of the 
serialized group's array, host name, 
and authentication credentials. 

I/O error Target block resides outside of 

normal file system boundary. Run 
f sck(lM) to verify file system. 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"bindresvport : couldn't 
alloc mbuf" 



"cku_recvf rom: no body!" 

"clntkudp_create - Fatal 
header serialization 
error. " 

"clntkudp_create: socket 
bind problem" 

"clntkudp_create : socket 
creation problem" 

"datalock - can't lock 
%d pages" 



"datalock (stack) - 
%can't lock %d pages" 



'device 0x%: bad dir ino 
!>d at offset %d:%s" 



"drive c%dd%d has 
inadequate capacity of 
%d blocks" 

"drive c%dd%d is not a 
disk" 



"duplicate IP address!! 
sent from Ethernet 
address: %x:%x" 



Kernel status An mbuf could not be allocated to 
bind to a reserved port for kernel 
RPC. 

I/O error Tried to check for free memory on 

nonexistent memory segment. 

Kernel error An xdrON) routine failed while 

attempting to serialize the kernel 
RPC call message header. 

Kernel error An attempt to bind a kernel RPC 

socket to a reserved port has failed. 

Kernel error An attempt to allocate a socket for a 

kernel RPC failed. 

Kernel error Ran out of available memory. 

Increase physical memory or reduce 
kernel memory use with 
kconfig(lM). 

Kernel error Ran out of available memory. 

Increase physical memory or reduce 
kernel memory use with 
kconfig(lM)- 

I/O error Kernel found a bad directory entry in 

the file system. Run f sck(lM) to 
verify file system. 

I/O error Drive has reported an unreasonable 

device size. 



I/O error The SCSI protocol defined device 

type, as reported by the device 
hardware, says that this is not a disk 
drive. Check the hardware configura- 
tion. This error should never occur 
when using standard Apple hardware. 

I/O error The Ethernet software has received a 

packet that claims to be from the 
same IP address as the current 
machine. Check the file /etc /hosts 
for conflicts. 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"exec error: u_error 
%d pn path " 



'file: table is full" 



"floppy: %d floppy %s 
Drive %d has %d head%s 
floppy: drive %d is %s 
drive" 

"inode: table is full" 



"ku_fastsend: No source 
address" 



"ku_f astsend: dup ip/udp 
hdr MGET failed" 

"ku_fastsend: frag MGET 
failed" 

"ku_fastsend: if_output 
failed: error=%d, 
am=%x" 



"ku_f astsend: ip/udp hdr 
MGET failed" 

"ku recvfrom: len = %d" 



'lo%d: can't handle af%d' 



Kernel error An error occurred while performing 

an exec on a new process. The 
kernel was unable to return to the 
calling process. 

Kernel error File descriptor table is full. Reduce 

number of open files or increase the 
value of the variable NFILE with 
kconfig(lM). 

I/O status Printed at boot time, this message 

gives information on floppy hardware 
attached to the system. 

Kernel error Incore inode table is full. Reduce 

number of inodes in use or increase 
the value of the variable N I NODE with 
kconfig(lM). 

Kernel error No internet address could be found 

for the interface specified in the 
allocated routine. 

Kernel error Failed to let memory act as a buffer 

for the EtherTalk card. 

Kernel error Failed to let memory act as a buffer 

for the EtherTalk card. 

Kernel error An interface's output routine indicated 

a failure. The error returned is 
indicated. Other information is for 
debugging purposes only. 

Kernel error Failed to let memory act as a buffer 

for the EtherTalk card. 

Kernel error An NFS packet was received with a 

length greater than UDPMSGSIZE. 

I/O error The interface was presented with a 

message using addresses formatted 
in an unsuitable address family. The 
packet was dropped. The only 
address family currently supported is 
AFJNET (INTERNET). 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"m_expand returning 0" 



"memregadd: adding memory" Kernel status 



"msginit - can't get %d 
pages" 



"nfs read: failed, errno 
%d" 



"nfs write: failed, 
errno %d fh %o %d" 



"pcbsetaddr failed %d" 



'proc on q" 



'proc: table is full' 



"procdup - can't get %d 
pages for udot" 



"puterrno: unmapped UNIX 
error %d" 



"pvalidate (%x, %x, %x) 
•failed" 



Kernel error Someone tried to allocate mbuf 

buffers twice. Also caused when the 
IPC code cannot get additional 
memory for buffers. Add physical 
memory or reduce use. 

Overlooking some physical memory 
according to the value of the variable 

MAXPMEM. 

Kernel error Ran out of memory trying to initialize 

message queues. Reduce kernel 
memory use with kconf ig(lM). 

Kernel status Read request from NFS server failed. 
Check local and remote hardware and 
connections. 

Kernel status Write request from NFS server failed. 
Check local and remote hardware and 
connections. 

Kernel error The number given is the error 

number returned by the call 

in_pcbsetaddr. 

Kernel status The kernel attempted to enable a 
process that was already enabled to 
run. 

Kernel error Process table is full. Reduce the 

number of processes in use or 
increase the value of the variable 
NPROC with kconfig(lM). 

Kernel status A kernel memory allocation request 
failed. Add more memory or run 
fewer processes. 

I/O error An error unknown to this kernel 

occurred during an NFS operation. 
Check remote hosts for errors. 

Kernel error The kernel tried to load a page table 

entry for an invalid region. You 
should never see this error. If it does 
occur, check for hardware problems. 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"qattach: out of queues" 



"revarp: Requesting 
Internet address for 
"Found Internet 
address %x" 



"rwvp: short write, 
resid %d vp %x bn %d" 

"shractl - couldn't lock %d 
pages in memory" 

"sptreserve: No kernel 
virtual space" 



"sptseggrow: no memory" 
"sptseggrow: no memory 2" 



"sptseggrow: soft limit 
exceded" 



"strioctl: illegal ioctl 
ack cell" 



Fatal error There is not enough memory to set 

up and run streams. Normally, no 
other error messages will follow 
because the kernel will be unable to 
continue. Add physical memory to 
the system or reduce kernel memory 
use with kconf ig(lM). 

Kernel status Status message on finding the ARP 

address. This message appears only if 
it took more than two attempts to 
find the ARP. It is possible for 
multiple occurrences of the first 
message to appear, but the second 
message should appear only once. 

Kernel status Less data was taken in NFS write 
than was requested. Check sizes in 
/etc/ f stab for NFS remote server. 

Kernel error Couldn't get enough memory. Add 

physical memory or reduce use. 

Kernel error Kernel ran out of free memory while 

trying to grow its segment table. The 
kernel is likely to crash soon after 
this message appears. Add more 
physical memory to the system. 

Kernel error Kernel ran out of free memory while 

trying to grow its segment table. The 
kernel is likely to crash soon after 
this message. Add more physical 
memory to the system. 

Kernel status The kernel has allocated an unusually 
large amount of virtual memory 
(checked to SPTCOUNT defined in 
/sys/useg.h). 

I/O error Unknown stream ioctl acknowledge 

was returned to stream head. Check 
hardware and communication 
connections. If using an AST card for 
AppleTalk, check for error in 
downloading of software. 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"stropen: out of streams" 



"stropen:out of queues" 



" svckudp_send : 
xdr_replymsg failed" 

"sxt cannot allocate link 
buffers" 



"text lock - can't lock %d 
pages" 



"total memory size: %d 
bytes available memory: 
%d bytes": 

"tp->t_maxf c 
reduced to %d." 

"uinter: process %d tried 
to delete %d's layer" 

"uptalloc - can't get %d 
page" 



"useracc - couldn't lock 
page" 



Fatal error There is not enough memory to set 

up and run streams. Normally, no 
other error messages will follow 
because the kernel will be unable to 
continue. Add physical memory to 
the system or reduce kernel memory 
use with kconf ig(lM). 

Fatal error There is not enough memory to set 

up and run streams. Normally, no 
other error messages will follow 
because the kernel will be unable to 
continue. Add physical memory to 
the system or reduce kernel memory 
use with kconf ig(lM). 

Kernel error An xdrGN) routine failed while 

attempting to serialize a reply to an 
NFS request. 

Kernel error Kernel is unable to allocate memory. 

Increase physical memory or reduce 
the kernel memory use with 
kconf ig(lM). This error will most 
likely be fatal. 

Kernel error Ran out of available memory. 

Increase physical memory or reduce 
kernel memory use with 
kconfig(lM). 

Kernel status Printed at startup or reset. 



Kernel status 
Kernel error 
Kernel error 

Kernel error 



MAXSC was changed on the running 
kernel, which is not recommended. 

This most likely ends in a panic. 



Kernel has run out of memory. 
Reduce kernel memory usage or add 

physical memory. 

Couldn't lock a page into memory for 
IO request. 
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Table 6-2 (continued) 

A/UX kernel warning messages 



Message 



Type 



Comments 



"xdr_mbuf: long crosses 
mbuf s ! " 



"xdr__mbuf: put long, 
long crosses mbuf s ! " 



"can't get mbuf: 
xdr_rrok failed" 

"xdrmbuf_putbuf : mclgetx 
failed" 



Kernel error An xdrON) routine failed while 

attempting to serialize or deserialize a 
block buffer. It found a long integer 
crossing a block buffer boundary. 

Kernel error An xdr(3N) routine failed while 

attempting to serialize or deserialize a 
block buffer. It found a long integer 
crossing a block buffer boundary. 

I/O error Kernel failed to get an mbuf buffer. 

Reduce use or increase variable 
NMBUFS with kconfig(lM). 

Kernel error Kernel failed to get buffer for 

a network transfer. 
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Section 7 



Terminal Display 
Problems 



The terminal type of the A/UX Initial Console Emulator is set to the default value of 
mac2. Your terminal type can be reset automatically to VT100 when you use r login, 
tip, cu, or another data communications utility to log into a non-A/UX system, 
because the non-A/UX system does not know about the mac2 terminal type. 

One immediate effect of this type change is that the scrolling region of the screen is 
reduced to 23 or 24 lines, which is much smaller than the 35-line Macintosh II region. 
After you log off the remote system, your terminal type might still be set to VT100. If 
your terminal type seems wrong after a remote login, check it with this command: 

echo $TERM 

If the response is not mac2, reset your terminal type: 

□ If you are using the Bourne shell (sh) as your login shell, you can reset your 
terminal type with the command 

TERM=mac2 

□ If you are using the C shell (csh), use the command 

setenv TERM mac2 

After your terminal type is correctly set to mac2, reset the scrolling region with the 
command 

tset 

If there is obsolete material on your screen, especially material outside of the scrolling 
region, you can clear the screen with the command 

clear 

After you run a graphics package, such as X Windows, under the A/UX Initial Console 
Emulator, your screen may be left in a strange state. To repaint the screen and restore 
the console to its normal state, enter the command 

screenrestore 
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Serial Port Difficulties 



Your terminal might drop characters while you are simultaneously using either of the 
serial (tty) ports and backing up files to floppy disks or using the Ethernet. The serial 
ports have lower priority than the floppy disk driver or the network, making it possible 
to overrun the hardware buffer and lose input characters. This phenomenon is most 
noticeable at higher baud. 
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RS-232 Cables 



This section describes how to make RS-232 cables that will be connected to 
conventional terminals and computers. A conventional cable is a DB-25P/S (where P 
stands for plug and 5" stands for socket) configured as either a DTE or a DCE circuit. 
(For more information, see John E. McNamara, Technical Aspects of Data 
Communication, Second Edition, Digital Press, 1982.) To make this cable, start with 
the cable (part number M0187) used to connect an Apple ImageWriter® II to a 
Macintosh Plus, and cut the cable in half. Then wire the cable to a DB-25 connector 
according to the diagram in Figure 9-1. Depending on which half you start with, the 
M0187 cable will have one of the two color codes shown on the left side of the figure. 

The DCE cable shown in Figure 9-1 has been used successfully at Apple for connection 
to VT100 terminals, Zenith Z19 terminals, and the DZ11 ports on a DEC UNIBUS 
communications multiplexor. The cable illustrated in Figure 9-2 is for the less 
common DTE connector. Note that the cable in Figure 9-2 does not present modem 
control signals, but that it is wired as a "null modem." 

♦ Note: Pins 1 and 22 of the DB-25 connector are not used for either cable. 
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RS-232 DCE cable for Macintosh II 
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RS-232 DTE cable for Macintosh II 
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Section 10 



Manual Pages 



This section contains a list of minor corrections to manual pages and a collection of 
replacement manual pages. These corrections apply to the command reference pages 
in A/UX Command Reference, A/UK Programmer's Reference, and AAJX System 
Administrator's Reference. 



Errata 

This section lists minor changes to the manual pages in the AAJX reference manuals. 
Please mark these changes on the affected pages, or mark the pages with a reference to 
these errata. The on-line manual pages are correct. 



checkmm(l ) 

The command /usr/bin/checkmml is invoked by checkmm(l). Add a reference to 
checkmml under FILES on the checkmmQ) page. The checkmml command is not 
meant to be executed by users. 



doma±nname(l ) 

The man page for domainname(l) states that the binary can be found in /usr/bin. 
The correct pathname is /bin/domainname. 
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eqn(l) 

The program checkeq(l) is documented on the page for eqn(l). Add a reference to 
checkeq(l) to the page for eqn(l), and add this line to the page: 

checkeq is a related program that reports missing or unbalanced delimiters and 
. EQ/.EN pairs. 

Amend the FILES section to include /bin /checkeq. 



ex(l) 

The text editor e (in /usr/bin/e) is another name for ex(l). Add to the ex(l) page a 
reference to e. 



f inger(l ) 

Insert the following paragraph above the words finger options include: 

finger may be used to look up users on a remote machine. To do so, specify name as 
user® host. If user is not supplied, a listing in standard format is provided for the 
remote machine. 



more(l) 

The page(l) command is a slight variation on more(l) and should be referenced on 
the same page. On the page for more(l), add /bin/page to the FILES section, and 
add to the SYNOPSIS section the line: 

page more_arguments 

To the DESCRIPTION section, add this paragraph: 

page functions similarly, except that the screen is cleared before each screenful is 
displayed (but only if a full screenful is displayed), and k - 1 rather than k - 2 lines are 
displayed in each screenful, where k is the number of lines the terminal can display. 



put(l) 

A/UX does not support this command. Mark this page of the manual for deletion. 
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take(l) 

A/UX does not support this command. Mark this page of the manual for deletion. 



uucp(l) 

The shell scripts uudemon . day, uudemon . hr, and uudemon . wk are part of the 
uucp package. Add the following shell scripts to the FILES section on the page for 
uucp(l): 

/usr/lib/uudemon.day perform once per day 

/usr/lib/uudemon.hr perform once per hour 

/usr/lib/uudemon . wk perform once per week 



autoconf ig(l M) 

Add a cross-reference to newunix(lM) in the SEE ALSO section. 

brc(lM) 

The system initialization script sysinitrc is part of brc(l). 

Add to the SYNOPSIS the line /etc /sysinitrc. 

Change the first paragraph of the DESCRIPTION to read: 

init executes sysinitrc, brc, bcheckrc, and re at system initialization, via 
entries in /etc/inittab. sysinitrc is executed before init starts up its initial 
level. The others are executed when the system is changed out of single-user mode, 
powerf ail executes whenever a system power failure is detected. 

Add a second paragraph to the DESCRIPTION, as follows: 
sysinitrc 

sysinitrc performs various system initialization tasks, including setting the internal 
clock, checking the root file system, setting host and domain names, and running 
autoconfiguration. 

Change the paragraph on powerf ail to read as follows: 

powerf ail is invoked when the system detects a power failure. It performs any last- 
minute activities as desired before powering down. 
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Add to the FILES section these entries: 

/etc/sysinitrc 

/etc/sethost 

/etc/setmactime 

Add to the SEE ALSO section references to startup(lM), autoconf ig(lM), and 
query(lM). 



mount (1M) 

Note that a space is required between all flag options and their arguments. 

Also, the options quota and noquota should be described under MOUNT FLAG 
OPTIONS, -o, options valid on all file systems: 

quota usage limits enforced 

noquota usage limits not enforced 

In the same section, the default should be (rw, noquota) , and not (rw, suid) as 
described. 

You should move the description of the hide option to the man page for f stab(4), as 
an example of a mount option (valid in the mnt_opts field) because this option is not 
particularly useful from the mount command, but should be used within entries in the 
file /etc/fstab. 



pname(lM) 

The man page for pname(lM) describes a -f option. This option is currently 
unsupported. Also, there is a typographical error in the same description. The 
sentence should read as follows: 

If a partition is already associated with the specified slice, pname will first unrecognize 
that partition. 



trpt(lM) 

The man page for trpt(lM) states that the binary can be found in /etc/trpt. The 
correct pathname is /usr /etc/trpt. The SYNOPSIS should also indicate the full 
pathname of this command. 
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gethostent(3N) 

The man page for gethostent(3N) is incorrect. Remove all references to 
gethostent, sethostent, and endhostent. File the page under 
gethostbyaddr(3N). 



rexec 



(3N) 



This page incorrectly refers to gethostent(3N). A/UX does not support this call. 
The first line of the DESCRIPTION should read, "rexec looks up the host referenced 
by *ahost using gethostbyname(3N)." 



mastermind(6) 

There is no man page for /us r /games /mastermind. This program plays the game 
of Mastermind. When invoked, it will prompt you to decide if you want instructions. 



Replacement pages 

The following pages are replacements for pages printed in the A/UX reference 
manuals. Insert them alphabetically by section into the appropriate manuals. 
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NAME 

checkinstall - check installation of boards 

SYNOPSIS 

/etc/checkinstall ethertalk 

DESCRIPTION 

checkinstall performs a quick test to see if the named board 
has been installed or not The only board type currently supported 
is the Apple EtherTalk board, which is indicated by the argument 

ethertalk. 

FILES 

/etc/checkinstall 

SEE ALSO 

etheraddr(lM). 
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NAME 

enscript - convert text files to PostScript format for printing 

SYNOPSIS 

enscript [-12BGghKklmoqRr] [-Llines] [-ffont] 
[-Fhfont] [-bheader] [-pour] [spoolopts] \files] 

DESCRIPTION 

enscript reads plain text files, converts them to PostScript 
format, and spools them for printing on a PostScript printer. 
Fonts, headings, and limited formatting options may be specified. 

For example: 

enscript -paleph boring.txt 

processes the file called boring . txt for PostScript printing, 
writing the output to the file aleph. 

enscript -2r boring. c 

prints a two-up landscape listing of the file called boring . c on 
the default printer (see below). 

Font specifications have two parts: A font name as known to 
POSTSCRIPT (e.g., Times -Roman, Times -Roman 
Boldltalic , Helvetica, Courier), and a point size (1 
point*l/72 inch). So, Courier-Bold8 is 8 point Courier 
Bold, Helvetical2 is 12 point Helvetica. 

The environment variable ENSCRIPT may be used to specify de- 
faults. The value of ENSCRIPT is parsed as a string of argu- 
ments before the arguments that appear on the command line. For 
example 

ENSCRIPT=' -f Times-Roman8 ' 

sets your default body font to 8 point Times Roman. 

The possible options are: 

-2 set in two columns. 

-1 set in one column (the default). 

-r rotate the output 90 degrees (landscape mode). This is 
good for output that requires a wide page or for program 
listings when used in conjunction with -2. "enscript 
-2 r files' * is a nice way to get program listings. 

-R don't rotate, also known as portrait mode (the default). 
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-G print in gaudy mode: causes page headings, dates, page 
numbers to be printed in a flashy style, at some slight per- 
formance expense. 

-1 simulate a line printer: make pages 66 lines long and omit 

headers. 

-B omit page headings. 

-bheader 

sets the string to be used for page headings to header. 
The default header is constructed from the file name, its 
last modification date, and a page number. 

-Llines set the maximum number of lines to output on a page. 
enscript usually computes how many to put on a page 
based on point size, and may put fewer per page than re- 
quested by lines. 

-ffont sets the font to be used for the body of each page. De- 
faults to CourierlO, unless two column rotated mode is 
used, in which case it defaults to Courier7. 

-Fhfont sets the font to be used for page headings. Defaults to 

Courier-BoldlO. 

-pout causes the PostScript file to be written to the named file 
rather than being spooled for printing. As a special case, 
-p - will send the PostScript to the standard output 

-g enables the printing of files containing non-printing char- 
acters. Any file with more than a small number of non- 
printing characters is suspected of being garbage, and is 
not printed unless this option is used. 

-o If enscript cannot find characters in a font, the miss- 
ing characters are listed 

-q causes enscript to be quiet about what it is doing. 
enscript won't report about pages, destination, omit- 
ted characters, etc. Fatal errors are still reported to the 
standard error output 

-k enables page prefeed (if the printer supports it). This al- 
lows simple documents (e.g., program listings in one 
font) to print somewhat faster by keeping the printer run- 
ning between pages. 

-K disable page prefeed (the default). 
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enscript(l) 



-h suppress printing of job burst page. 
ENVIRONMENT 



ENSCRIPT 



PSLIBDIR 



PSTEMPDIR 



LPDEST 



string of options to be used by 

enscript. 

path name of a directory to use instead 
of /usr/lib/ps for enscript prolo- 
gue and font metric files. 

path name of temporary directory to 
use instead of XPSTEMDIRX of 
spooled temporary files. 

the name of a printer for lp to use. If 
LPDEST is not set, enscript will 
spool to a printer class named 

PostScript. 



FILES 

/usr/bin/enscript 
/usr/lib/ps/* .afm 
/usr/lib/ps /enscript 



pro 



font metrics files, 
prologue for enscript 
files. 
SEE ALSO 

cancel(l), lp(l), lpr(l), lprm(l), lpstat(l), pr(l), 
ps630(l), getopt(3). 
FEATURES 

Options and the ENSCRIPT environment string are parsed in 
getopt(3) fashion. 
BUGS 

Long lines are truncated. Line truncation may be off by a little bit 
as printer margins vary. There should be a "wrap" option and 
multiple (truncated or wrapped) columns. 
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NAME 

makedev - prepare troff description files 

SYNOPSIS 

makedev files 

DESCRIPTION 

makedev reads description files about a particular device and 
converts them into a form suitable for reading by troff(l). 
Input to makedev is in the format described in font (5). 

FILES 

/usr/bin/makedev 

SEE ALSO 

trof f (1), f ont(5). 

A Typesetter-independent TROFF, Brian W. Kernighan (Bell 

Laboratories, 1982) 

Adventures with Typesetter-Independent TROFF, Mark Kahrs and 

Lee Moore (University of Rochester TR 159, 1985) 
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NAME 

ns lookup - query name servers interactively 

SYNOPSIS 

nslookup 

ns lookup - server 

ns lookup host-to-find [ server ] 

DESCRIPTION 

nslookup is a program which queries DARPA Internet domain 
name servers. 

server is a either the host name or address for a name server. 

nslookup has two modes: interactive and non-interactive. 
Interactive mode allows the user to query the name server for 
information about various hosts and domains or print a list of 
hosts in the domain. Non-interactive mode is used to print just the 
name and Internet address of a host or domain. 

Interactive mode is entered in the following cases: 

a) when no arguments are given (the default name server will be 
used), and 

b) when the first argument is a hyphen (-) and the second argu- 
ment is the host name of a name server. 

Non-interactive mode is used when the name of the host to be 
looked up is given as the first argument The optional second argu- 
ment specifies a server. 

INTERACTIVE COMMANDS 

Commands may be interrupted at any time by typing a 
CONTROL-c. To exit, enter the end-of-file signal, CONTROL-d. 
The command line length must be less than 80 characters. 

Note: an unrecognized command will be interpreted as a host 
name. 

host [server] 

Look up information for host using the current default server, 
or using server if it is specified. 

server domain 
lserver domain 

Change the default server to domain, lserver uses the 



1 - November, 1987 



nslookup(l) nslookup(l) 



initial server to look up information about domain while 
server uses the current default server. If an authoritative 
answer can't be found, the names of servers that might have 
the answer are returned. 



root 

Changes the default server to the server for the root of the 
domain name space. Currently, the host sri-nic.arpa 
is used. (This command is a synonym for the lserver 
sri-nic.arpa.) The name of the root server can be 
changed with the set root command. 

finger [name] [> filename] 

finger [name] [» filename] 

Connects with the ringer server on the current host. The 
current host is defined when a previous lookup for a host was 
successful and returned address information (see the set 
querytype=A command), name is optional. > and » 
can be used to redirect output in the usual manner. 

Is domain [> filename] 

Is domain [» filename] 

Is - a domain [> filename] 

Is -a domain [» filename] 

Is -h domain [> filename] 

Is -h domain [» filename] 

List the information available for domain. The default output 
contains host names and their Internet addresses. The -a 
option lists aliases of hosts in the domain. The -h option 
lists CPU and operating system information for the domain. 
When output is directed to a file, hash marks are printed for 
every 50 records received from the server. 

view filename 

Sorts and lists the output of the Is command with 
more(l). 

help 

? Prints a brief summary of commands. 
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3et keyword[=value] 

This command is used to change state information that 
affects the lookups. Valid keywords are: 

all 

Prints the current values of the various options to set. 
Information about the current default server and host is 
also printed. 

[no] debug 

Turn debugging mode on. A lot more information is 
printed about the packet sent to the server and the result- 
ing answer. 
(Default = nodebug, abbreviation = [no] deb) 

[no]defname 

Append the default domain name to every lookup. 
(Default = nodef name, abbreviation = [nojdef ) 

domain=mzm£ 

Change the default domain name to name. The default 
domain name is appended to all lookup requests if the 
def name option has been set 
(Default = value in /etc/resolv.conf, abbrevia- 
tion = do) 

que rytype=va/u£ 

Change the type of information returned from a query to 
one of: 

A the host's Internet address (the default). 

CNAME the canonical name for an alias. 

HINFO the host CPU and operating system type. 

MD the mail destination. 

MX the mail exchanger. 

MG the mail group member. 

MINFO the mailbox or mail list information. 

MR the mail rename domain name. 

Other types specified in the RFC883 document are valid but 
aren't very useful. 
(Abbreviation = q) 

[no]recurse 

Tell the name server to query other servers if it does not 
have the information. 
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(Default = recur se, abbreviation = [no]rec) 

ret ry =number 

Set the number of retries to number. When a reply to a 
request is not received within a certain amount of time 
(changed with set timeout), the request is resent. 
The retry value controls how many times a request is 
resent before giving up. 
(Default = 2, abbreviation = ret) 

zoot=host 

Change the name of the root server to host. This affects 

the root command. 

(Default = sri-nic . arpa, abbreviation = ro) 

t ime o u t =number 

Change the time-out interval for waiting for a reply to 

number seconds. 

(Default =10 seconds, abbreviation = t) 

[no]vc 

Always use a virtual circuit when sending requests to 

the server. 

(Default = novc, abbreviation = [no]v) 

TUTORIAL 

The domain name space is tree-structured and currently has five 
top-level domains: 

• com (for commercial establishments) 

• edu (for educational institutions) 

• gov (for government agencies) 

• o rg (for not for profit orginizations) 

• mil (for MILNET hosts) 

If you are looking for a specific host, you need to know something 
about the host's organization in order to determine the top-level 
domain it belongs to. For instance, if you want to find the Internet 
address of a machine at UCLA, do the following: 

a) Connect with the root server using the root command. The 
root server of the name space has knowledge of the top-level 
domains. 

b) Since UCLA is a university, its domain name is ucla . edu. 
Connect with a server for the ucla.edu domain with the 
command server ucla . edu. The response will print the 
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names of hosts that act as servers for the domain ucla . edu. 
Note that the root server does not have information about 
ucla .edu but knows the names and addresses of hosts that 
do. All future queries will be sent to the UCLA name server. 

c) To request information about a particular host in the domain, 
type the host name. To request a listing of hosts in the UCLA 
domain, use the Is command. The Is command requires a 
domain name (in this case, ucla . edu) as an argument 

Note that if you are connected with a name server that handles 
more than one domain, all lookups for host name must be fully 
specified with its domain. For instance, the domain 
harvard.edu is served by seismo.css.gov, which also 
services the ess .gov and Cornell . edu domains. A lookup 
request for the host a i ken in the harvard.edu domain must 
be specified as aiken.harvard.edu. However, the set 
domain=name and set def name commands can be used to 
automatically append a domain name to each request 

After a successful lookup of a host use the finger command to 
see who is on the system or to finger a specific person. To get 
other information about the host use the set 
querytype=va/u£ command to change the type of information 
desired and request another lookup, (finger requires value to be 
A.) 

DIAGNOSTICS 

If the lookup request was not successful, an error message is 
printed. Possible errors are: 

Time-out 

The server did not respond to a request after a certain amount 
of time (changed with set time out =value) and a certain 
number of retries (changed with set retry=vo/u£). 

No information 

Depending on the query type set with the set 
query type command, no information about the host was 
available, though the host name is valid. 

Non-existent domain 

The host or domain name does not exist 

Connection refused 

Network is unreachable 

The connection to the name or finger server could not be 
made at the current time. This error commonly occurs with 
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finger requests. 

Server failure 

The name server found an internal inconsistency in its data- 
base and could not return a valid answer. 

Refused 

The name server refused to service the request 

Format error 

The name server found that the request packet was not in the 
proper format. This error should not occur. It would indicate 
a bug in the program. 

FILES 

/etc /bind/ tools /nslookup 

/etc/resolv.conf initial domain name and 

name server addresses 
SEE ALSO 

named(lM), resolver(4). 

RFC-882, RFC-883 (DNN Network Information Center, SRI 

International) 
AUTHOR 

Andrew Cherenson 
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NAME 

query - query the user for input 

SYNOPSIS 

query [ -t [seconds] ] [ -r [response] ] [ -m ] 

DESCRIPTION 

By default, query reads a line from standard input and echoes it 
to standard output. Options include: 

-t [seconds] 

Timeout after seconds seconds. If no input has been seen by 
this time, query will echo the default response value to 
standard output and standard error. 

-r [response] 

Change the default response to response. The default 
response is y if not set with this option. The -r option is 
only useful in conjunction with -t. 

-m Watch for a mouse click. If the mouse does get clicked, exit 
status 2 is returned. Note: This option will be ignored if any 
other program (such as a toolbox application) is currently 
using the mouse. 

DIAGNOSTICS 

Exit status is if everything is OK, 1 for usage error, 2 if mouse is 
pressed when query -m is in use. 

FILES 

/etc/query 

SEE ALSO 

line(l). 



November, 1987 



query(l) query(l) 



- 2 - November, 1987 



rcnvt(l) rcnvt(l) 



NAME 

rcnvt - resource file format converter 

SYNOPSIS 

rcnvt[ -s] [-f ] -iinput-file -ooutput-file 

DESCRIPTION 

rcnvt converts Macintosh resource files from the old . re 3 for- 
mat to the new AppleDouble or AppleSingle formats. The com- 
mand line options and their meanings are 

-i input-file 

Specify the name of the old format file to be converted. The 
. res extension should not be included. 

-o output-file 

Specify the name of the output file, which will be in 
AppleSingle or AppleDouble format The % prefix on 
AppleDouble resource forks will be automatically appended 
by the program and should not be included here. 

-3 Create an AppleSingle format output file instead of the 
default Apple Double format file. AppleSingle combines 
both the resource and data forks into a Single A/UX file, and 
is most useful when the Resource fork seldom or never 
changes, or on files with no data fork. Use of AppleSingle 
format is very inefficient when both the resource and data 
forks are frequently expanded. 

-f Suppress errors when creating AppleSingle format files that 
have no data fork. 

AppleSingle is particularly nice for executable Macintosh object 
files. Directory listings look much cleaner because each Macin- 
tosh file maps to a single A/UX file with no % prefix or . res 
suffix. 

rcnvt can also be used when transferring a resource file from the 
native Macintosh Environment to A/UX. If this transfer is done 
via the mf s(l) command, AppleSingle or AppleDouble format 
files are created. However, if the transfer is done via a terminal 
emulator program, the file created will probably just contain a 
copy of the Macintosh file's resource fork. In this case, rcnvt 
can be used to convert the file to either AppleSingle or AppleDou- 
ble format Note that this technique of file transfer will not 
preserve the Macintosh file's type or creator. These can be set 
with the settc(l) command. 
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FILES 

/usr/toolboxbin/rcnvt 

SEE ALSO 

mf s(l), settc(l). 
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NAME 

remlogin - remote sign on 

SYNOPSIS 

remlogin 

DESCRIPTION 

The remlogin command is used when a user initially signs on 
from a remote host 

When remlogin is invoked from a virtual terminal server pro- 
cess, it asks for a user name, and, if appropriate, a password. 
Echoing is turned off (if possible) during the typing of the pass- 
word, so it will not appear on the written record of the session. 

After a successful login, accounting files are updated and the user 
is informed of the existence of mail. The message of the day is 
printed, as is the time of his last login. Both are suppressed if he 
has a .hushlogin file in his home directory; this is mostly 
used to make life easier for non-human users, such as uucp. 

remlogin initializes the user and group IDs and the working 
directory, then executes a command interpreter (usually csh(l)) 
according to specifications found in a password file. Argument 
of the command interpreter is the name of the command inter- 
preter with a leading dash (-). 

remlogin also modifies the environment environ(7) with 
information specifying home directory, command interpreter, ter- 
minal type (if available) and user name. 

If the file /etc/nologin exists, login prints its contents on 
the user's psuedo terminal and exits. This is used by 
shutdown(lM) to stop users logging in when the system is about 
to go down. 

FILES 

/usr/ spool/mail/* 

/etc/utmp accounting 

/usr/adm/wtmp accounting 

/usr/spool/mail/* mail 

/etc/motd message-of-the-day 

/etc/passwd password file 

/etc/nologin stops logins 

. hushlogin makes login quieter 

SEE ALSO 

mail(l), passwd(l), getty(lM), rlogind(lM), 
telnetd(lM), init(lM), shutdown(lM), rlogin(lN), 
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passwd(5), environ(7). 

DIAGNOSTICS 

Login incorrect 

if the name or the password is bad. 

No Shell 

cannot open password file 

no directory 

consult a system administrator. 

BUGS 

remlogin uses two undocumented options, -r is used by the 
remote login server, rlogind(lM) to force remlogin to enter 
into an initial connection protocol. -h is used by 
telnetd(lM) and other servers to list the host from which the 
connection was received. 
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NAME 

screenrestore - restore the A/UX Initial Console Emulator 
screen 

SYNOPSIS 

screenrestore 

DESCRIPTION 

screenrestore restores the A/UX Initial Console Emulator 
screen bitmap and resets the mac2 vtlOO-like console emulator to 
an initialized state, screenrestore is used to clean up after 
certain graphics programs (e.g. X Windows) which may leave the 
screen in a strange state. 

FILES 

/usr /bin/ screenrestore 
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NAME 

term - emulate a vtlOO in A/UX Toolbox windows 

SYNOPSIS 

term 

DESCRIPTION 

term is a terminal emulator program, built on top of the A/UX 
Toolbox. It emulates a DEC vtlOO. term uses the standard 
Macintosh user interface and supports multiple, resizable win- 
dows. The source code and makefile can be found in 
/usr/lib/mac/examples/term. This is a good example of 
how to write software that uses the A/UX Toolbox. 

FILES 

/usr/toolboxbin/term 
/usr/lib/mac/examples/term/* source code 

SEE ALSO 

toolboxdaemon(lM). 
MUX Toolbox Guide 
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NAME 

ethers, ether_ntoa, ether_aton, ether_ntohost, 
ether_hostton, ether_line - Ethernet address mapping 
operations 

SYNOPSIS 

#include <sys/types .h> 

#include <3y3/socket .h> 

#include <net/if.h> 

#include <netinet/in.h> 

#include <netinet/if_ether .h> 

char * 
ether_ntoa (e) 

struct ether_addr *e; 

struct ether_addr * 
ether_aton(s) 

char *s; 

ether_ntohost (hostname, e) 
char *hostname; 
struct ether_addr *e; 

ether_hostton (hostname, e) 
char *hostname; 
struct ether_addr *e; 

ether_line (1, e, hostname) 
char *1; 

struct ether_addr *e; 
char *hostname; 

DESCRIPTION 

These routines are useful for mapping 48-bit Ethernet numbers to 
their ASCII representations or their corresponding host names, 
and vice versa. 

The function ether_ntoa converts a 48-bit Ethernet number 
pointed to by e to its standard ACSII representation; it returns a 
pointer to the ASCII string. The representation is of the form: 
xixrjcvcjc'jc: where x is a hexadecimal number between and 255. 
The function ether_aton converts an ASCII string in the stan- 
dard representation back to a 48-bit Ethernet number; the function 
returns NULL if the string cannot be scanned successfully. 
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The function ether_ntohost maps an Ethernet number 
(pointed to by e) to its associated hostname. The string pointed to 
by hostname must be long enough to hold the hostname and a null 
character. The function returns zero upon success and non-zero 
upon failure. Inversely, the function ether_hostton maps a 
hostname string to its corresponding Ethernet number; the func- 
tion modifies the Ethernet number pointed to by e. The function 
also returns zero upon success and non-zero upon failure. 

The function ether_line scans a line (pointed to by 1) and 
sets the hostname and the Ethernet number (pointed to by e). The 
string pointed to by hostname must be long enough to hold the 
hostname and a null character. The function returns zero upon 
success and non-zero upon failure. The format of the scanned line 
is described by ethers(4). 

FILES 

/etc/ethers 

/etc /ethers .byaddr Yellow Pages control file 

/etc /ethers . byname Yellow Pages control file 

SEE ALSO 

ethers(4). 
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NAME 

HOSTNAME - hostname and domainname database 

DESCRIPTION 

HOSTNAME resides in the /etc directory and consists of one 
line containing the following items of information 

hostname domainname 

Items are separated by any number of blanks and/or tabs. There 
must be no white space at the beginning of the line. 

hostname is the name of the local host machine and domainname 
is the name of the Yellow Pages domain on which the local host 
resides. 

EXAMPLE 

magic apple 

FILES 

/etc /HOSTNAME 

SEE ALSO 

hostname(l), domainname(l), chgnod(lM). 

A/UX Installation Guide 

RFC-882, RFC-883, RFC-920, RFC-921, RFC-952, RFC-953, 

RFC-973, RFC-974 (DNN Network Information Center, SRI 

International) 
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NAME 

NETADDRS - network address database 

DESCRIPTION 

The NETADDRS file resides in /etc and contains information 
regarding the network addresses of each EtherTalk board on the 
local machine. For each board, a single line should be present 
with the following items of information: 

unit-number internet-address broadcast-address netmask 

Items are separated by any number of blanks and/or tab charac- 
ters. Lines must not begin with blanks or tabs, netmask should be 
blank if subnets are not being supported. 

EXAMPLE 

The following is a sample NETADDRS file for a machine on two 
networks; only the second is subnetted. 

89.53 89.0 

1 91.1.0.48 91.1.0.0 255.255.0.0 

FILES 

/etc /NETADDRS 

SEE ALSO 

autoconf ig(lM), if conf ig(lM). 
AIUX Network System Administration 

RFC-917, RFC-922, RFC-944, RFC-950 (DDN Network Informa- 
tion Center , SRI International) 
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NAME 

ethers - Ethernet address to hostname database or YP domain 

DESCRIPTION 

The /etc/ethers file contains information regarding the 
known (48 bit) Ethernet addresses of hosts on the Internet. For 
each host on an Ethernet, a single line should be present with the 
following items of information: 

ethernet-address hostname 

Items are separated by any number of blanks and/or tabs. Use # 
to introduce a single line or midline comment 

The standard form for ethernet-address is xvcjcvcvcx: where x is a 
hexadecimal number between and 255, representing one byte. 
The address bytes are always in network order, hostname may 
contain any printable character other than a space, tab, newline, or 
comment character. The hostnames in the ethers file should 
correspond to the hostnames in the /etc/hosts file (see 
hosts(4)). 

The ether JineQ routine from the Ethernet address manipulation 
library, ethers(3N) may be used to scan lines of the ethers 
file. 

FILES 

/etc/ethers 

SEE ALSO 

ethers(3N), hosts (4) . 
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NAME 

rpc - rpc program number data base 

SYNOPSIS 

/etc/rpc 

DESCRIPTION 

The The rpc file contains user readable names that can be used 
in place of rpc program numbers. Each line has the following 
items of information: 

server-name program-number [ alias... ] 

Items are separated by any number of blanks and/or tab charac- 
ters. Use # to indicate the beginning of a comment; characters up 
to the end of the line are not interpreted by routines which search 
the file. 



EXAMPLE 

# 

# rpc 1 . 

# 

portmapper 






1 86/07/07 


100000 


portmap sunrpc 


rstatd 


100001 


rstat rup perfmeter 


rusersd 


100002 


rusers 


nf 3 


100003 


nf sprog 


ypserv 


100004 


ypprog 


mountd 


100005 


mount showmount 


ypbind 


100007 




walld 


100008 


rwall shutdown 


yppasswdd 


100009 


yppasswd 


etherstatd 


100010 


etherstat 


rquotad 


100011 


rquotaprog quota rquota 


sprayd 


100012 


spray 


3270_mapper 


100013 




r je_mapper 


100014 




select ion_3vc 


100015 


selnsvc 


database_svc 


100016 




rexd 


100017 


rex 


alis 


100018 




sched 


100019 




llockmgr 


100020 




nlockmgr 


100021 




x25 . inr 


100022 




statmon 


100023 




status 


100024 
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FILES 

/etc/rpc 

SEE ALSO 

rpc(3N). 
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NAME 

icmp - Internet Control Message Protocol 

SYNOPSIS 

None; included automatically with inet(5F). 

DESCRIPTION 

The Internet Control Message Protocol, ICMP, is used by gate- 
ways and destination hosts which process datagrams to communi- 
cate errors in datagram-processing to source hosts. The datagram 
level of Internet is discussed in ip(5P). ICMP uses the basic sup- 
port of IP as if it were a higher level protocol; however, ICMP is 
actually an integral part of IP. ICMP messages are sent in several 
situations; for example: when a datagram cannot reach its destina- 
tion, when the gateway does not have the buffering capacity to 
forward a datagram, and when the gateway can direct the host to 
send traffic on a shorter route. 

The Internet protocol is not designed to be absolutely reliable. 
The purpose of these control messages is to provide feedback 
about problems in the communication environment, not to make 
IP reliable. There are still no guarantees that a datagram will be 
delivered or that a control message will be returned. Some 
datagrams may still be undelivered without any report of their 
loss. The higher level protocols which use IP must implement 
their own reliability mechanisms if reliable communication is 
required 

The ICMP messages typically report errors in the processing of 
datagrams; for fragmented datagrams, ICMP messages are sent 
only about errors in handling fragment of the datagram. To 
avoid the infinite regress of messages about messages etc., no 
ICMP messages are sent about ICMP messages. ICMP may how- 
ever be sent in response to ICMP messages (for example, 
ECHOREPLY). There are eleven types of ICMP packets which 
can be received by the system. They are defined in this excerpt 
from <netinet/ip_icmp.h>, which also defines the values of some 
additional codes specifying the cause of certain errors. (Com- 
ments have been stripped for this listing.) 

/* 

* Definition of type and code field values 

*/ 
#define ICMP_ECHOREPLY 
#define ICMP_UNREACH 3 

#define ICMP UNREACH NET 
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tdefine ICMP_UNREACH_HOST 1 
#define ICMP_UNREACH_PROTOCOL 2 
#define ICMP_UNREACH_PORT 3 
#define ICMP_UNREACH_NEEDFRAG 4 
#define ICMP__UNREACH_SRCFAIL 5 
#define ICMP_SOURCEQUENCH 4 
#define ICMP_REDIRECT 5 

#define ICMP_REDIRECT_NET 
#define ICMP_REDIRECT_HOST 1 
#define ICMP_REDIRECT_TOSNET 2 
#define ICMP_REDIRECT_TOSHOST 3 
#define ICMP_ECHO 8 

♦define ICMP_TIMXCEED 11 

#define ICMP_TIMXCEED_INTRANS 
#define ICMP_TIMXCEED_REASS 1 
#define ICMP_PARAMPROB 12 
#define ICMP_T STAMP 13 

#define ICMP_TSTAMPREPLY 14 
#define ICMP_IREQ 15 

#define ICMP_IREQREPLY 16 

Arriving ECHO and TSTAMP packets cause the system to gen- 
erate ECHOREPLY and TSTAMPREPLY packets. IREQ packets 
are not yet processed by the system, and are discarded. 
UNREACH, SOURCEQUENCH, TMXCEED and PARAM- 
PROB packets are processed internally by the protocols imple- 
mented in the system, or reflected to the user if a raw socket is 
being used; see ip(5P). REDIRECT, ECHOREPLY, 
TSTAMPREPLY and IREQREPLY are also reflected to users of 
raw sockets. In addition, REDIRECT messages cause the kernel 
routing tables to be updated; see routing(5N). 

SEE ALSO 

inet(5F), ip(5P). 

Internet Control Message Aotocol, RFC792, J. Postel, USC-ISI 

BUGS 

IREQ messages are not pro essed properly: the address fields are 
not set 

Messages which are source roiled are not sent back using inverted 
source routes, but rather go back through the normal routing 
mechanisms. 
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NAME 

arp - address resolution display and control 

SYNOPSIS 

/etc/arp hostname 

/etc/arp -a [ unix ] [ kmem ] 

/etc/arp -d hostname 

/etc/arp -s hostname ether -addr [temp] [pub] 

/etc/arp -f filename 

DESCRIPTION 

The arp program displays and modifies the Internet-to-Ethernet 
address translation tables used by the address resolution protocol 
(arp(5)). 

With no flags, the program displays the current ARP entry for 
hostname. The host may be specified by name or by number, using 
Internet dot notation. With the -a flag, the program displays all 
of the current ARP entries by reading the table from the file 
kmem (default /dev/kmem) based on the kernel file unix 
(default /unix). 

With the -d flag, a superuser may delete an entry for the host 
called hostname. 

The -s flag is given to create an ARP entry for the host called 
hostname with the Ethernet address ether-addr . The Ethernet 
address is given as six hex bytes separated by colons. The entry 
will be permanent unless the word temp is given in the com- 
mand. If the word pub is given, the entry will be "published"; 
i.e., this system will act as an ARP server, responding to requests 
for hostname even though the host address is not its own. 

The -f flag causes the file filename to be read and multiple 
entries to be set in the ARP tables. Entries in the file should be of 
the form 

hostname ether-addr [temp] [pub] 

FILES 

/etc/arp 
/dev/kmem 

SEE ALSO 

inet(3N), arp(5), if conf ig(lM). 
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NAME 

etheraddr - get an Ethernet address 

SYNOPSIS 

/etc/etheraddr [slot] 

DESCRIPTION 

etheraddr prints the Ethernet address stored in ROM on the 
board in slot number slot. 

DIAGNOSTICS 

etheraddr exits with the return status if an Ethernet interface 
and valid ROM are available. A nonzero exit status indicates 
failure to find or read an Ethernet address for the host 

FILES 

/etc/etheraddr 

SEE ALSO 

slots(3X), ae(5), arp(5P), inet(5F), intro(5). 
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NAME 

eu - update autorecovery files 

SYNOPSIS 

/etc/ en file 

DESCRIPTION 

eu is used to maintain the files needed by autorecovery(8). It 
copies file to the eschatology partition(s) and updates the relevant 
entry in /etc/eschatology/init2f iles. If file is not 
found in /etc/eschatology/init2f iles, an entry as 
described in cml(4) will be created. 

To prevent inconsistent updates while eu is running, a lockfile, 
/etc/eschatology/FCML.lock, is used to single-thread 
the updates to the file systems and the cml(4) file. Once eu is 
complete, this lockfile is removed. 

FILES 

/etc/eu 

/etc/eschatology/init2f iles the data base 
/etc/eschatology/FCML . lock the lock file 
SEE ALSO 

autorecovery(8), escher(lM), cml(4). 
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NAME 

eupdate - update important files for autorecovery 

SYNOPSIS 

/etc/eupdate 

DESCRIPTION 

eupdate updates appropriate system files for autorecovery use. 
This command should be used after a machine has been 
reconfigured with autoconf ig(lM) or after modification of 
important relevant files (see below). 

FILES 

/etc /HOSTNAME 

/etc/NETADDRS 

/etc/eupdate 

/etc/inittab 

/etc/ startup. d/BNET 

/etc/ startup. d/ae 6 

/unix 

SEE ALSO 

autoconf ig(lM), eu(lM), autorecovery(8). 
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NAME 

f ingerd - remote user information server 

SYNOPSIS 

/usr/etc/in . f ingerd 

DESCRIPTION 

f ingerd is a simple protocol based on RFC742 that provides an 
interface to the name and finger programs at several network 
sites. The program reports status information about either the sys- 
tem at the moment or a particular person in depth. There is no 
required format and the protocol consists mostly of specifying a 
single "command line". 

f ingerd listens for TCP requests at port 79. Once connected it 
reads a single command line terminated by a <CR><LF> which is 
passed to f inger(l). f ingerd closes its connections as soon 
as the output is finished. 

If the line is null (i.e. just a <CRxLF> is sent) then finger 
returns a "default" report that lists all people logged into the sys- 
tem at that moment 

If a login name is specified (so f ingerd receives 
eric<CR><LF>), then more extensive information is provided for 
that user, whether logged in or not Allowable user names in the 
command line include both login names and user names. If a 
name is ambiguous, all possible derivations are returned. 

FILES 

/usr/etc/in. f ingerd 

SEE ALSO 

finger(l). 

RFC742 (DNN Netwo± Information Center, SRI International) 

BUGS 

Connecting directly to the server from a TIP or an equally 
narrow-minded TELNET-protocol user program can result in 
meaningless attempts at option negotiation being sent to the 
server, which will foul up the command line interpretation, 
f ingerd should be enhanced to filter out IAC's and perhaps 
even respond negatively (IAC WON'T) to all option commands 
received. 
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NAME 

newunix - prepare for new kernel configuration 

SYNOPSIS 

/etc/newunix [bnet] [nfs] [nonet] [toolbox] 
[notoolbox] 

DESCRIPTION 

newunix begins the process of configuring a new kernel by ins- 
talling (or uninstalling) the appropriate scripts and driver object 
files needed by autoconf ig(lM). The appropriate argument to 
newunix depends on the type of kernel desired: basic network- 
ing (bnet), Network File System (nfs), A/UX toolbox (toolbox), 
non-networking (nonet), no toolbox capabilities (notoolbox). 

In order to complete the kernel configuration process, 
autoconf ig(lM) should be run after newunix. 

FILES 

/etc/newunix 

/etc/boot, d/* driver object files 

/etc/install. d/* installation scripts 

/etc/master, d/* script files 

/etc/ start up. d/* startup programs 

/etc/uninstall.d/* uninstaUation scripts 

SEE ALSO 

autoconf ig(lM). 
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NAME 

ping - network debugging 

SYNOPSIS 

/usr/etc/ping host [timeout] 

DESCRIPTION 

ping repeatedly sends an icmp echo packet to host and reports 
whether or not a reply was received. It keeps trying until timeout 
seconds have elapsed, or an answer is received. The default 
timeout is 20 seconds. The host argument can be a name or an 
internet address. 

FILES 

/usr/etc/ping 

SEE ALSO 

icmp(5P). 
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NAME 

revnetgroup - reverse the netgroup file 

SYNOPSIS 

/etc/yp/ revnetgroup [-u] [-h] 

DESCRIPTION 

revnetgroup reverses the netgroup file. Options are 

-u reverse by username 

-h reverse by hostname 

Each line in the output file will begin with a key formed by con- 
catenating the host or user name with the domain name. The key 
will be followed by a tab, then the comma-separated, newline- 
terminated list of groups to which the user or host belongs. 

Exception: Groups to which everyone belongs (universal groups) 
will not be included in the list The universal groups will be listed 
under the special name *. 

NOTE 

revnetgroup is a filter used in updating the /etc/yp data 
bases. It is not expected to be of general utility. 

FILES 

/etc/yp/ revnetgroup 
/etc/netgroup 

SEE ALSO 

ypmake(lM), netgroup(4). 
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NAME 

startup - run startup programs at boot time 

SYNOPSIS 

/etc/startup 

DESCRIPTION 

startup is a shell script, called from /etc/sysinitrc, 
which runs a set of startup routines to initialize autoconfigured 
modules that are part of the kernel. An example startup script is 
/etc/startup. d/BNET which initializes the loop interface 
loO. 

NOTE 

startup is called from /etc/sysinitrc at system startup. 
It is not expected to be of general utility. 

FILES 

/etc/startup 
/etc/ startup. d/* 

SEE ALSO 

autoconf ig(lM), sysinitrc(lM). 
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NAME 

stdhosts - convert Internet addresses to standard form 

SYNOPSIS 

/etc/yp/ stdhosts file 

DESCRIPTION 

stdhosts converts Internet addresses to a standard form. 
Addresses are read from a file (usually /etc /hosts). 

NOTE 

stdhosts is a filter used in updating the /etc/yp data bases. 
It is not expected to be of general utility. 

FILES 

/etc/yp/ stdhosts 

/etc/hosts the host table 

SEE ALSO 

ypmake(lM), hosts(4). 
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NAME 

toolboxdaemon - set up for and clean up after A/UX Toolbox 
programs 

SYNOPSIS 

toolboxdaemon 

DESCRIPTION 

toolboxdaemon is a daemon that should be running in the 
background whenever you plan to run programs that use the A/UX 
Toolbox. 

When an A/UX Toolbox program is started, toolboxdaemon 
sets up the shared data and shared text segments. After an A/UX 
Toolbox program exits, toolboxdaemon cleans up the struc- 
tures allocated to the program. 

To have toolboxdaemon started every time the machine 
enters multiuser mode, change the tbO entry in the file 
/etc/inittab. The default system inittab file has this 
entry: 

tbO :2.:of f : /etc/toolboxdaemon > /dev/syacon 2>&1 

Change the word "off" to "respawn," so that the line reads 

tb0:2: respawn: /etc/toolboxdaemon > /dev/syscon 2>&1 

If this line does not appear in your /etc/inittab file, add it. 

When you are in the A/UX shell, you can determine whether 
toolboxdaemon is running with the ps(l) command: 

ps -ef 

EXAMPLE 

The command 

/etc/toolboxdaemon & 

starts toolboxdaemon running in the background. 

FILES 

/us r/toolboxbin/ toolboxdaemon 
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NAME 

uucico, uu s hell - transfer files queued by uucp or uux 

SYNOPSIS 

/usr/lib/uucp/uucico [-dspooldir] [-ggrade] [-rrole] 
[-R] [ssystem] [-xdebug] [-L] [-t turnaround] 

/usr/lib/uucp/uushell 

DESCRIPTION 

uucico performs the actual work involved in transferring files 
between systems. uucp(lC) and uux(lC) merely queue requests 
for data transfer which uucico processes. 

uushell serves as the login shell for the user uucp. 
uushell sets the environment variable TZ and calls uucico . 

The following options are available to uucico. 

-dspooldir 

Use spooldir as the spool directory. The default is 

/usr/ spool /uucp. 

-ggrade Only send jobs of grade grade or higher this transfer. 
The grade of a job is specified when the job is queued 
by uucp or uux. 

-rrole role is either 1 or 0; it indicates whether uucico is 
to start up in master or slave role, respectively. 1 is 
used when running uucico by hand or from 
cron(lM). is used when another system calls the 
local system. Slave role is the default 

-R Reverse roles. When used with the -rl option, this 

tells the remote system to begin sending its jobs first, 
instead of waiting for the local machine to finish. 

-ssystem 

Call only system system. If -s is not specified, and 
-rl is specified, uucico will attempt to call all sys- 
tems for which there is work. If -s is specified, a call 
will be made even if there is no work for that system. 
This is useful for polling. 

-xdebug Turn on debugging at level debug. Level 5 is a good 
start when trying to find out why a call failed. Level 9 
is very detailed. Level 9 9 is absurdly verbose. If role 
is 1 (master), output is normally written to the standard 
error output. If the standard error output is unavailable, 
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output is written to 

/usr/spool/uucp/AUDIT/system. When role is 
(slave), debugging output is always written to the 
AUDIT file. 

-L Only call "local" sites. A site is considered local if the 

device-type field in L.sys is one of LOCAL, DIRor 
TCP. 

-tturnaround 

Use turnaround as the line turnaround time (in minutes) 
instead of the default 30. If turnaround is missing or 0, 
line turnaround will be disabled. After uucico has 
been running in slave role for turnaround minutes, it 
will attempt to run in master role by negotiating with the 
remote machine. In earlier versions of uucico, a 
transfer of many large files in one direction would hold 
up mail going in the other direction. With the tur- 
naround code working, the message flow will be more 
bidirectional in the short term. This option only works 
with newer uucicos and is ignored by older ones. 

If uucico receives a SIGFPE (see kill(l)), it will toggle the 
debugging on or off. 

uucico is commonly used either of two ways: as a daemon run 
periodically by cron(lM) to call out to remote systems, and as a 
"shell" for remote systems who call in. For calling out periodi- 
cally, a typical line in a crontab file would be: 

* * * * /usr/lib/uucp/uucico -rl 

This will run uucico every hour in master role. For each system 
that has transfer requests queued, uucico calls the system, logs 
in, and executes the transfers. The file L . sys is consulted for 
information about how to log in, while L-devices specifies 
available lines and modems for calling. 

For remote systems to dial in, an entry in the passwd(4) file must 
be created, with a login "shell" of uushell. For example: 

nuucp:Password:5 :5 : : /usr/spool/uucppublic:/usr/lib/uucp/uushell 

The UID for UUCP remote logins is not critical, so long as it 
differs from the UUCP Administrative login. The latter owns the 
UUCP files, and assigning this UID to a remote login would be an 
extreme security hazard. 
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FILES 

/usr/spool/uucp/D . hostnameX/ 

/usr/lib/uucp/ UUCP internal 

files/utilities 

/usr/lib/uucp/L-devices Local device descriptions 

/usr/lib/uucp/L-dialcodes Phone numbers and 

prefixes 

/usr/lib/uucp/L . cmds Remote command permis- 

sions list 

/usr/lib/uucp/L. sys Host connection 

specifications 

/usr/lib/uucp/USERFILE Remote directory tree per- 

missions list 



/us r/ spool/ uucp/ 
/usr/spool/uucp/AUDIT/* 
/usr/spool/uucp/C . / 
/usr/spool/uucp/D . / 



Spool directory 

Debugging audit trails 

Control files directory 

Incoming data file direc- 
tory 

/usr/spool/uucp/D .hostname/ 

Outgoing data file direc- 
tory 

/usr/spool/uucp/D. hostnameX/ 

Outgoing execution file 
directory 

/usr/spool/uucp/CORRUPT/ Place for corrupted C. and 

D. files 

/usr/spool/uucp/ERRLOG 

/usr/spool/uucp/LOGFILE 

/usr/spool/uucp/LCK/LCK. .* 



UUCP internal error log 
UUCP system activity log 



/usr/spool/uucp/SYSLOG 
/usr/spool/uucp/STST/* 
/usr/spool/uucp/TM. / 



Device lock files 

File transfer statistics log 

System status files 

File transfer temp direc- 
tory 
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/usr/spool/uucp/X. / Incoming execution file 

directory 

/usr/spool/uucppublic Public access directory 

SEE ALSO 

uucp(lC), uuq(lC), uux(lC), uuclean(lM), uuxqt(lM). 
D. A. Nowitz and M. E. Lesk, A Dial-Up Network of UNIX Sys- 
tems. 
D. A. Nowitz, Uucp Implementation Description. 
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NAME 

uuxqt - UUCP execution file interpreter 

SYNOPSIS 

/usr/lib/uucp/uuxqt [ -xdebug ] 

DESCRIPTION 

uuxqt interprets "execution files" created on a remote system 
via uux(lC) and transferred to the local system via uucico(lM). 
When a user uses uux to request remote command execution, it 
is uuxqt that actually executes the command. Normally, 
uuxqt is forked from uucico to process queued execution 
files; for debugging, it may also be run manually by the UUCP 
administrator. 



uuxqt runs in its 

/usr/spool/uucp/ .XQTDIR. It 
this directory when necessary. 

FILES 

/usr/spool/uucp/LCK.XQT 
/usr/lib/uucp/L.cmds 

/usr/lib/uucp/USERFILE 

/usr/spool/uucp/LOGFILE 
/usr/spool/uucp/LCK.XQT 
/usr/spool/uucp/X. / 

/usr/spool/uucp/ .XQTDIR 

SEE ALSO 

uucp(lC), uux(lC), uucico(lM). 



own subdirectory, 

copies intermediate files to 



Remote command permis- 
sions list 

Remote directory tree per- 
missions list 

UUCP system activity log 
uuxqt lock file 
Incoming execution file 
directory 
uuxqt running directory 
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NAME 

autorecovery - file system repair procedure 

DESCRIPTION 

Autorecovery facilities check and repair A/UX filesystems. They 
include a variety of programs, some of which run under the 
stand-alone shell, and some of which run under A/UX. The 
preparatory work is done on an incremental basis using the A/UX 
programs. The actual checking and correction tasks are performed 
within the stand-alone portion of the boot sequence, and are 
invoked manually as desired. The checking and correction por- 
tions of autorecovery can also run automatically upon booting, if 
the stand-alone environment has been set up properly. 

autorecovery is the name of a stand-alone shell variable that 
contains the autorecovery command string. This command string 
is executed whenever you boot A/UX (see sash(8)). The com- 
mand string has been initially set to echo no 
autorecovery as an indication that autorecovery is not being 
run. 

To request autorecovery manually, run esch directly from the 
stand-alone shell. An alternative is to set autorecovery so 
that the desired form of the esch command is run automatically 
upon booting. 

The A/UX progams that help support the proper functioning of the 
esch autorecovery function are those in the SEE ALSO section 
with the designation "1M" (indicating a system administrator 
command). 

SEE ALSO 

escher(lM), eu(lM), eupdate(lM), esch(8). sash(8). 
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NAME 

esch - standalone file system repair 

SYNOPSIS 

esch [-b] [-c cluster-number] [-f] [-v] 

DESCRIPTION 

esch attempts to insure a minimal A/UX file system exists for a 
multiuser boot. When possible, it will correct bad blocks, repair 
file system inconsistencies and replace corrupt or missing files, 
esch is intended to be run when there is reason to suspect that the 
A/UX file systems have been damaged. 

Flag options to esch are: 

-b bypasses bad block checking functions. 

-c cluster-number 

allows the user to specify the autorecovery cluster number. 

-f does not perform fsck (see fsck(lM)). 

-v reports any corrective measures taken. 

esch must be run in the standalone environment before the A/UX 
system is booted. When the system is powered on or A/UX is 
rebooted, and the boot dialog is cancelled, the standalone shell 
(see sash(8)) prompt will appear and the esch command line 
may be entered. 

esch may be run automatically by setting the sash(8) variable 
autorecovery to the desired esch command line. 

A hard disk may be divided into partitions. Each partition con- 
tains one file system (see f s(4)). Information on all the partitions 
on a disk is kept in the disk partition map (see dpme(4)) for that 
disk. One of the fields in a dpme is the cluster number. This is 
used to identify the group of partitions esch should use. 

esch requires that all partitions reside on one disk, esch will 
read the cluster number from nvram (see nvram(7)) and locate 
all the partitions in that cluster. A cluster must contain a root par- 
tition, a swap partition and at least one autorecovery partition. A 
cluster may also contain a partition known to esch as the usr 
partition. There may be multiple autorecovery partitions in a clus- 
ter. 

Autorecovery file systems contain copies of files that are neces- 
sary for a minimal multiuser A/UX system. If new versions of 
commands, programs or files are installed on the system, the 
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autorecovery file systems should be updated using eu(lM) or 
escher(lM). 

esch will check each file system for bad blocks. This is done by 
verifying that each block can be read. If possible, any blocks that 
cannot be read will be spared by the hardware or alt blocked (see 
altblk(4)) by the software. If neither of these is successful, the 
block number is added to a list of blocks that is passed to f sck. 
fsck will add these blocks to a file associated with inode one; 
this has the effect of removing the blocks from the file system. 
Checking for bad blocks is a time consuming process. This phase 
of autorecovery may be omitted using the -b flag option. It is 
advisable to occasionally run esch without the -b flag option to 
be sure any bad blocks have been dealt with in the appropriate 
manner. 

esch will then do an fsck on each file system. This fsck is 
similar to running fsck with the -y flag option. All question- 
able files will be removed from the file system. If fsck should 
fail or if the superblock is unreadable, a mkf s (see mkf s(lM)) 
will be performed on the file system. 

After the file systems have been checked for consistency, esch 
will enter the file check merge (fcm) phase. The configuration 
master list (see cml(4)) is a list of files required for a multiuser 
A/UX system. This file gives rules about the attributes of each 
required file. The file check merge phase of esch will check 
each file in the cml for conformity to the specified file attributes 
(size, version, check sum, permissions, etc). If a file does not con- 
form to these rules, esch will attempt to replace it with a copy 
from an autorecovery file system. If the file in question is found 
on an autorecovery file system, it must conform to the cml rules 
or it will not be placed on the root or usr file system. 

FILES 

/etc/eschatology/init2files 

SEE ALSO 

escher(lM), eu(lM), eupdate(lM), f sck(lM), mkf s(lM), 
altblk(4), cml(4), dpme(4), fs(4), autorecovery(8), 
sash(8). 

"System Startup and Shutdown" in AJUX Local System Adminis- 
tration. 

WARNINGS 

esch must never be interrupted! Do not power off the system nor 
push the reset button while esch is running. If esch is 
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interrupted, major file system damage may result or entire file sys- 
tems may be destroyed. 

each will only attempt to replace files on two file systems. These 
are the root file system and a file system that is intended to be 
mounted on /usr. Any other file systems will be ignored by 

esch. 

The superblock of a file system contains information describing 
the file system. If esch is unable to read the superblock of a file 
system, or if the superblock has a bad magic number, the file sys- 
tem is not usable and an mkf s will be performed upon the file 
system. Everything on the file system will be removed! All user 
files will be gone and cannot be restored since the only files 
esch restores will be those listed in the cml. 

If a file system should become full while esch is copying a 
replacement file to it, esch will attempt to free up space by 
deleting files from /lost+found, /tmp, /usr/ lost +found 
or /usr /tmp (depending upon whether the file system is root 
and/or usr). Subdirectories and their contents will also be 
removed from these directories. If the directories have been emp- 
tied and there is still no room to copy required files, esch will 
terminate with an error. 
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